-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideCollections">\r
- <title id="titleGuideCollections">Collections</title>\r
- <para>Geeqie provides the ability to build lists of images, regardless of the location of the files on disk.</para>\r
- <para>A collection window displays the contents of a collection. It allows the collection to be modified and access to the images contained in the collection.</para>\r
- <para>\r
- To open a new empty collection window select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>C</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>New collection</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <para>\r
- To open an existing collection, select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>O</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Open collection</guimenuitem>\r
- </menuchoice>\r
- . A dialog will appear requesting the location of the collection file. A window will the open containing the selected collection. Recently opened or saved collections can also be opened by selecting the collection's file name from the Open recent sub menu of the file menu.\r
- </para>\r
- <para>\r
- To delete or rename a collection, select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>O</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Open collection</guimenuitem>\r
- </menuchoice>\r
- , right-click on the collection you wish to delete or rename, and then select\r
- <emphasis role="strong">Delete</emphasis>\r
- or\r
- <emphasis role="strong">Rename</emphasis>\r
- .\r
- </para>\r
- <para>The collection window consists of a pane to display the contents of the collection, and a status bar along the bottom of the window.</para>\r
- <para />\r
- <section id="Iconpane">\r
- <title>Icon pane</title>\r
- <para>The icon pane displays images contained in the collection as thumbnails in a grid, by default the file names also appear below each thumbnail.</para>\r
- <para>\r
- The Icon pane works exactly like the Icon view mode of the\r
- <link linkend="GuideMainWindowFilePane" endterm="titleGuideMainWindowFilePane" />\r
- in a main window, but with the addition that the contents of the collection can be organized with drag and drop.\r
- </para>\r
- <para>\r
- A\r
- <emphasis role="strong">context menu</emphasis>\r
- is available for the icon pane by right clicking the mouse or pressing the Menu key.\r
- </para>\r
- <para>\r
- <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />\r
- are available in the collection window:\r
- </para>\r
- <para>\r
- The\r
- <emphasis role="strong">selection</emphasis>\r
- can be changed using the keyboard and mouse the same as in a\r
- <link linkend="GuideMainWindowFilePane" endterm="titleGuideMainWindowFilePane" />\r
- of the main window.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Statusbar">\r
- <title>Status bar</title>\r
- <para>The status bar displays the total number of images in the collection, and the number of selected images in parenthesis. A progress bar also displays whenever thumbnails are loading from disk.</para>\r
- <para />\r
- </section>\r
- <section id="DragandDrop">\r
- <title>Drag and Drop</title>\r
- <para>Drag and drop can be initialized with the primary or middle mouse buttons. Dragging an image that is selected will include all selected images in the drag. Dragging an image that is not selected will drag only that image.</para>\r
- <para>Dropping files and folders onto the collection window will add them to the collection, they will be inserted at the location of the drop. A red arrow will indicate the location of the drop as files are dragged over the collection window. When one or more folders are included in the drop list, a menu will appear to select how to handle the contents of the folders.</para>\r
- <para>To move images within the collection to change their order, initiate a drag for the selected image(s) and then move the mouse to the desired location within the window. A red arrow will appear to assist in determining the destination of the dragged images. Release the drag to move the images to the new location in the list.</para>\r
- <note>\r
- <para>\r
- When renaming or moving files within Geeqie, the contents of collections located in the\r
- <link linkend="GuideReferenceConfig">collections folder</link>\r
- will automatically update to the new name or location.\r
- </para>\r
- </note>\r
- <para />\r
- </section>\r
- <section id="AppendImages">\r
- <title>Append Images</title>\r
- <para>Right-click menu items permit images to be appended from either another collection or from the currently selected folder.</para>\r
- <para />\r
- </section>\r
- <section id="RandomizedSort">\r
- <title>Randomized Sort</title>\r
- <para>\r
- Right-click menu item\r
- <emphasis role="strong">Sort</emphasis>\r
- , in addition to the standard sort methods, permits images to be randomly arranged.\r
- </para>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideCollections">
+ <title id="titleGuideCollections">Collections</title>
+ <para>Geeqie provides the ability to build lists of images, regardless of the location of the files on disk.</para>
+ <para>A collection window displays the contents of a collection. It allows the collection to be modified and access to the images contained in the collection.</para>
+ <para>
+ To open a new empty collection window select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>C</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>New collection</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <para>
+ To open an existing collection, select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>O</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Open collection</guimenuitem>
+ </menuchoice>
+ . A dialog will appear requesting the location of the collection file. A window will the open containing the selected collection. Recently opened or saved collections can also be opened by selecting the collection's file name from the Open recent sub menu of the file menu.
+ </para>
+ <para>
+ To delete or rename a collection, select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>O</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Open collection</guimenuitem>
+ </menuchoice>
+ , right-click on the collection you wish to delete or rename, and then select
+ <emphasis role="strong">Delete</emphasis>
+ or
+ <emphasis role="strong">Rename</emphasis>
+ .
+ </para>
+ <para>The collection window consists of a pane to display the contents of the collection, and a status bar along the bottom of the window.</para>
+ <para />
+ <section id="Iconpane">
+ <title>Icon pane</title>
+ <para>The icon pane displays images contained in the collection as thumbnails in a grid, by default the file names also appear below each thumbnail.</para>
+ <para>
+ The Icon pane works exactly like the Icon view mode of the
+ <link linkend="GuideMainWindowFilePane" endterm="titleGuideMainWindowFilePane" />
+ in a main window, but with the addition that the contents of the collection can be organized with drag and drop.
+ </para>
+ <para>
+ A
+ <emphasis role="strong">context menu</emphasis>
+ is available for the icon pane by right clicking the mouse or pressing the Menu key.
+ </para>
+ <para>
+ <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />
+ are available in the collection window:
+ </para>
+ <para>
+ The
+ <emphasis role="strong">selection</emphasis>
+ can be changed using the keyboard and mouse the same as in a
+ <link linkend="GuideMainWindowFilePane" endterm="titleGuideMainWindowFilePane" />
+ of the main window.
+ </para>
+ <para />
+ </section>
+ <section id="Statusbar">
+ <title>Status bar</title>
+ <para>The status bar displays the total number of images in the collection, and the number of selected images in parenthesis. A progress bar also displays whenever thumbnails are loading from disk.</para>
+ <para />
+ </section>
+ <section id="DragandDrop">
+ <title>Drag and Drop</title>
+ <para>Drag and drop can be initialized with the primary or middle mouse buttons. Dragging an image that is selected will include all selected images in the drag. Dragging an image that is not selected will drag only that image.</para>
+ <para>Dropping files and folders onto the collection window will add them to the collection, they will be inserted at the location of the drop. A red arrow will indicate the location of the drop as files are dragged over the collection window. When one or more folders are included in the drop list, a menu will appear to select how to handle the contents of the folders.</para>
+ <para>To move images within the collection to change their order, initiate a drag for the selected image(s) and then move the mouse to the desired location within the window. A red arrow will appear to assist in determining the destination of the dragged images. Release the drag to move the images to the new location in the list.</para>
+ <note>
+ <para>
+ When renaming or moving files within Geeqie, the contents of collections located in the
+ <link linkend="GuideReferenceConfig">collections folder</link>
+ will automatically update to the new name or location.
+ </para>
+ </note>
+ <para />
+ </section>
+ <section id="AppendImages">
+ <title>Append Images</title>
+ <para>Right-click menu items permit images to be appended from either another collection or from the currently selected folder.</para>
+ <para />
+ </section>
+ <section id="RandomizedSort">
+ <title>Randomized Sort</title>
+ <para>
+ Right-click menu item
+ <emphasis role="strong">Sort</emphasis>
+ , in addition to the standard sort methods, permits images to be randomly arranged.
+ </para>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideColorManagement">\r
- <title id="titleGuideColorManagement">Color Management</title>\r
- <para>TBD.</para>\r
- <para>\r
- <link linkend="GuideOptionsColor" endterm="titleGuideOptionsColor" />\r
- </para>\r
-\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideColorManagement">
+ <title id="titleGuideColorManagement">Color Management</title>
+ <para>TBD.</para>
+ <para>
+ <link linkend="GuideOptionsColor" endterm="titleGuideOptionsColor" />
+ </para>
+
</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideFaq">\r
- <title>Frequently Asked Questions</title>\r
- <para />\r
- <section id="Imageviewing">\r
- <title>Image viewing</title>\r
- <para />\r
- <section id="HowdoIkeepimagessmallerthanthevisibleareafromenlargingwhenthezoomissettofittowindow">\r
- <title>How do I keep images smaller than the visible area from enlarging when the zoom is set to “fit to window” ?</title>\r
- <para>\r
- In the\r
- <link linkend="GuideOptionsImage">Preferences Image dialog</link>\r
- , disable “Allow enlargement of image for zoom to fit”.\r
- </para>\r
- <para />\r
- </section>\r
- </section>\r
- <section id="Commandline">\r
- <title>Command line</title>\r
- <para />\r
- <section id="HowdoIopenanimageinanexistingGeeqieapplication">\r
- <title>How do I open an image in an existing Geeqie application ?</title>\r
- <para>Use the “--remote” command line option to send commands to an existing Geeqie, for a list of commands supported by the remote switch run:</para>\r
- <programlisting>geeqie --remote-help</programlisting>\r
- <para />\r
- </section>\r
- <section id="HowdoIsettheslideshowdelaywhenstartingGeeqieinslideshowfromthecommandline">\r
- <title>How do I set the slide show delay when starting Geeqie in slide show from the command line ?</title>\r
- <para>The delay can not be set when used with the standard --slideshow command line switch, as --slideshow uses the delay stored in the configuration file.</para>\r
- <para>For this, use the remote command --slideshow-start to start the slide show after setting the delay with --delay=. The order of the command line is important. For example for a 12 second slide show delay use:</para>\r
- <programlisting>geeqie --remote --delay=12 --slideshow-start</programlisting>\r
- <para>Note that if geeqie is running prior to this command, the slide show should also be stopped prior to changing the delay:</para>\r
- <programlisting>geeqie --remote --slideshow-stop --delay=12 --slideshow-start</programlisting>\r
- <para />\r
- </section>\r
- </section>\r
- <section id="Miscellaneous">\r
- <title>Miscellaneous</title>\r
- <para />\r
- <section id="OpenCloseMultipleWindows">\r
- <title>How can I save and restore multiple Geeqie windows</title>\r
- <para>\r
- The option\r
- <link linkend="titleGuideOptionsLayout">Exit program when this window is closed</link>\r
- provides this facility.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="IwanttobeabletoeditimageswithGeeqie">\r
- <title>I want to be able to edit images with Geeqie</title>\r
- <para>\r
- Geeqie is an image\r
- <emphasis role="i">viewer</emphasis>\r
- . There is, and never will be, a plan to add editing features. I recommend gimp for image editing.\r
- </para>\r
- <para />\r
- </section>\r
- </section>\r
- <section id="ExifRotation">\r
- <title>Exif Auto Rotation</title>\r
- <para />\r
- <section id="HowdotheExifauto-rotationcommandswork">\r
- <title>How do the Exif auto-rotation commands work?</title>\r
- <para>\r
- Image auto-rotation works in either of two modes, set by\r
- <link linkend="MetadataMiscellaneous">Write altered image orientation to the metadata</link>\r
- option.\r
- </para>\r
- <para>\r
- <emphasis role="bold">Write altered image orientation to the metadata - not set:</emphasis>\r
- <para />\r
- If you change the orientation of an image using any of the available commands, the image will always be displayed in the modified orientation. This new orientation is stored in temporary data structures associated with each image file. When Geeqie closes, these changes will be lost.\r
- </para>\r
- <warning>\r
- <para>It is not possible to determine if the image as displayed is the original image or one which has been temporarily rotated.</para>\r
- </warning>\r
- <para>\r
- If the option\r
- <link linkend="Editmenu">Auto rotate image using EXIF information</link>\r
- is selected, any images which have Exif orientation data will also be shown rotated. However, any rotation you have selected manually will always over-ride the embedded Exif rotation value.\r
- </para>\r
- <para>\r
- <emphasis role="bold">Write altered image orientation to the metadata - set:</emphasis>\r
- <para />\r
- <para>If you change the orientation of an image using any of the available commands, this new orientation is stored in a metadata write queue.</para>\r
- <para>\r
- If the option\r
- <link linkend="Editmenu">Auto rotate image using EXIF information</link>\r
- is selected, any images which have Exif orientation data will be shown rotated, including any in the metadata write queue.\r
- </para>\r
- <para>\r
- However if the option\r
- <link linkend="Editmenu">Auto rotate image using EXIF information</link>\r
- is not selected, no images will be auto-rotated. If you have manually rotated any images, the metadata write icon on the status bar will alert you to that fact. Clicking the icon will give a list of the modified files.\r
- </para>\r
- </para>\r
- <para />\r
- </section>\r
- </section>\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideFaq">
+ <title>Frequently Asked Questions</title>
+ <para />
+ <section id="Imageviewing">
+ <title>Image viewing</title>
+ <para />
+ <section id="HowdoIkeepimagessmallerthanthevisibleareafromenlargingwhenthezoomissettofittowindow">
+ <title>How do I keep images smaller than the visible area from enlarging when the zoom is set to “fit to window” ?</title>
+ <para>
+ In the
+ <link linkend="GuideOptionsImage">Preferences Image dialog</link>
+ , disable “Allow enlargement of image for zoom to fit”.
+ </para>
+ <para />
+ </section>
+ </section>
+ <section id="Commandline">
+ <title>Command line</title>
+ <para />
+ <section id="HowdoIopenanimageinanexistingGeeqieapplication">
+ <title>How do I open an image in an existing Geeqie application ?</title>
+ <para>Use the “--remote” command line option to send commands to an existing Geeqie, for a list of commands supported by the remote switch run:</para>
+ <programlisting>geeqie --remote-help</programlisting>
+ <para />
+ </section>
+ <section id="HowdoIsettheslideshowdelaywhenstartingGeeqieinslideshowfromthecommandline">
+ <title>How do I set the slide show delay when starting Geeqie in slide show from the command line ?</title>
+ <para>The delay can not be set when used with the standard --slideshow command line switch, as --slideshow uses the delay stored in the configuration file.</para>
+ <para>For this, use the remote command --slideshow-start to start the slide show after setting the delay with --delay=. The order of the command line is important. For example for a 12 second slide show delay use:</para>
+ <programlisting>geeqie --remote --delay=12 --slideshow-start</programlisting>
+ <para>Note that if geeqie is running prior to this command, the slide show should also be stopped prior to changing the delay:</para>
+ <programlisting>geeqie --remote --slideshow-stop --delay=12 --slideshow-start</programlisting>
+ <para />
+ </section>
+ </section>
+ <section id="Miscellaneous">
+ <title>Miscellaneous</title>
+ <para />
+ <section id="OpenCloseMultipleWindows">
+ <title>How can I save and restore multiple Geeqie windows</title>
+ <para>
+ The option
+ <link linkend="titleGuideOptionsLayout">Exit program when this window is closed</link>
+ provides this facility.
+ </para>
+ <para />
+ </section>
+ <section id="IwanttobeabletoeditimageswithGeeqie">
+ <title>I want to be able to edit images with Geeqie</title>
+ <para>
+ Geeqie is an image
+ <emphasis role="i">viewer</emphasis>
+ . There is, and never will be, a plan to add editing features. I recommend gimp for image editing.
+ </para>
+ <para />
+ </section>
+ </section>
+ <section id="ExifRotation">
+ <title>Exif Auto Rotation</title>
+ <para />
+ <section id="HowdotheExifauto-rotationcommandswork">
+ <title>How do the Exif auto-rotation commands work?</title>
+ <para>
+ Image auto-rotation works in either of two modes, set by
+ <link linkend="MetadataMiscellaneous">Write altered image orientation to the metadata</link>
+ option.
+ </para>
+ <para>
+ <emphasis role="bold">Write altered image orientation to the metadata - not set:</emphasis>
+ <para />
+ If you change the orientation of an image using any of the available commands, the image will always be displayed in the modified orientation. This new orientation is stored in temporary data structures associated with each image file. When Geeqie closes, these changes will be lost.
+ </para>
+ <warning>
+ <para>It is not possible to determine if the image as displayed is the original image or one which has been temporarily rotated.</para>
+ </warning>
+ <para>
+ If the option
+ <link linkend="Editmenu">Auto rotate image using EXIF information</link>
+ is selected, any images which have Exif orientation data will also be shown rotated. However, any rotation you have selected manually will always over-ride the embedded Exif rotation value.
+ </para>
+ <para>
+ <emphasis role="bold">Write altered image orientation to the metadata - set:</emphasis>
+ <para />
+ <para>If you change the orientation of an image using any of the available commands, this new orientation is stored in a metadata write queue.</para>
+ <para>
+ If the option
+ <link linkend="Editmenu">Auto rotate image using EXIF information</link>
+ is selected, any images which have Exif orientation data will be shown rotated, including any in the metadata write queue.
+ </para>
+ <para>
+ However if the option
+ <link linkend="Editmenu">Auto rotate image using EXIF information</link>
+ is not selected, no images will be auto-rotated. If you have manually rotated any images, the metadata write icon on the status bar will alert you to that fact. Clicking the icon will give a list of the modified files.
+ </para>
+ </para>
+ <para />
+ </section>
+ </section>
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideImageManagement">\r
- <title id="titleGuideImageManagement">File Management</title>\r
- <para>Geeqie includes a set of utilities to copy, move, rename, and delete images. Cache maintenance utilities are also provided.</para>\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagementCopyMove.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagementRename.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagementDelete.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceManagement.xml" />\r
- <para />\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideImageManagement">
+ <title id="titleGuideImageManagement">File Management</title>
+ <para>Geeqie includes a set of utilities to copy, move, rename, and delete images. Cache maintenance utilities are also provided.</para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagementCopyMove.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagementRename.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagementDelete.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceManagement.xml" />
+ <para />
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideImageManagementCopyMove">\r
- <title>Copy and Move</title>\r
- <para>\r
- To copy a file in Geeqie select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>C</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Copy</guimenuitem>\r
- </menuchoice>\r
- and to move a file select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>M</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Move</guimenuitem>\r
- </menuchoice>\r
- . These operations also appear in the context menu of all images and files.\r
- </para>\r
- <para>The Copy and Move operations and dialogs behave the same in Geeqie, with the only difference being the final result. The remaining text of this page applies equally to the Copy and Move operations, for the remainder of this page these will be referred to as a Copy/Move operation.</para>\r
- <para>Initiating a Copy/Move operation will display a dialog to select the destination folder to Copy/Move the selected file, after the destination folder is selected Geeqie will proceed to Copy/Move the images to the destination. If an error occurs or a file exists with the same name as one of the files being Copy/Moved, a dialog will appear prompting how to handle the situation.</para>\r
- <para />\r
- <section id="TheCopyMovedialog">\r
- <title>The Copy/Move dialog</title>\r
- <para>This is the dialog that is displayed when initiating a Copy/Move operation. The dialog contains a row of buttons near the top, vertical list of bookmarks along the left side, a vertical list of folders in the current path, a text entry field, and a row of buttons along the bottom.</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Home button</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Activate this button to change the active path to your home folder.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>New Folder button</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Activate this to create a new empty folder as a sub folder of the active path. The new folder will appear in the folder list ready for you to type in the desired name.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Show Hidden check box</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enabling this check box will cause hidden folders to appear in the folder list.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Bookmark list</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- This list on the left side of the window allows you to save links to folders that are frequently used. Activating a bookmark will change the active path to that pointed to by the link. To add items to the bookmark list highlight a folder and press\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>B</keycap>\r
- </keycombo>\r
- </shortcut>\r
- , select “Add bookmark” from the folder's context menu, or drag a folder onto the bookmark list.\r
- <para />\r
- The bookmark has a context menu that can be displayed by clicking the right mouse button, or pressing the Menu key when a bookmark has the focus. From the context menu you can edit a bookmark, move it up or down in the list, or remove the bookmark from the list. A bookmark can also be moved by pressing Shift + Up or Shift + Down while it has the focus.\r
- </para>\r
- <para>A bookmark with the name "." is treated as a special case. Each time this bookmark is displayed, its path is loaded with Geeqie's current working folder. This bookmark, like any other, can be deleted and re-created at any time.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Folder list</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- This is the list that displays the folders contained in the active path. To change the active path to a folder displayed in this list double click the primary mouse button or highlight the folder with the keyboard and press\r
- <keycap>Enter</keycap>\r
- or\r
- <keycap>Spacebar</keycap>\r
- . This list has a context menu that allows renaming or bookmarking the selected folder. A folder can also be dragged onto the bookmark list to add a bookmark.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Path entry</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This text entry displays the active path of the dialog. The path can be directly edited using this entry. Tab completion is supported, and the drop down arrow will display a list of recently selected folders.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Copy/Move button</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The name of this button will differ depending on the selected operation, activating it will start the operation with the folder displayed in the path entry as the destination.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Cancel button</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Activate this button to close the dialog, the operation will be aborted.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Theerrordialog">\r
- <title>The error dialog</title>\r
- <para>If a problem occurs because Geeqie is unable to Copy or Move a selected file a dialog will appear to notify the user. The dialog will also ask if the operation should continue if one or more files remain to be Copied or Moved.</para>\r
- <para />\r
- </section>\r
- <section id="Theoverwritedialog">\r
- <title>The overwrite dialog</title>\r
- <para>If a file with the same name exists in the selected destination a dialog will appear to notify the user and ask how to resolve the conflict. The dialog will also display the source and destination images. The following possible solutions will be offered:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Auto rename</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enabling this check box to have Geeqie select a unique name for the destination file, the proposed new name will appear in the rename entry field.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Rename</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enable this check box to manually enter a new name for the file.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Overwrite</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Activate this will overwrite the existing file, or rename it if one of the rename check boxes are enabled.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Overwrite all</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Activating this will perform the same operation as the Yes button, however any further file name conflicts will be handled quietly in the same method as is selected for the current file.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Skip</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This button will skip doing anything to the file in question, and resume the operation with the next file. The source file will remain untouched.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Skip All</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This will perform the same as the Skip button, however any further file name conflicts will be quietly ignored for all remaining files.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Cancel</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This will close the dialog and stop the operation, all remaining files will be ignored.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImageManagementCopyMove">
+ <title>Copy and Move</title>
+ <para>
+ To copy a file in Geeqie select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>C</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Copy</guimenuitem>
+ </menuchoice>
+ and to move a file select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>M</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Move</guimenuitem>
+ </menuchoice>
+ . These operations also appear in the context menu of all images and files.
+ </para>
+ <para>The Copy and Move operations and dialogs behave the same in Geeqie, with the only difference being the final result. The remaining text of this page applies equally to the Copy and Move operations, for the remainder of this page these will be referred to as a Copy/Move operation.</para>
+ <para>Initiating a Copy/Move operation will display a dialog to select the destination folder to Copy/Move the selected file, after the destination folder is selected Geeqie will proceed to Copy/Move the images to the destination. If an error occurs or a file exists with the same name as one of the files being Copy/Moved, a dialog will appear prompting how to handle the situation.</para>
+ <para />
+ <section id="TheCopyMovedialog">
+ <title>The Copy/Move dialog</title>
+ <para>This is the dialog that is displayed when initiating a Copy/Move operation. The dialog contains a row of buttons near the top, vertical list of bookmarks along the left side, a vertical list of folders in the current path, a text entry field, and a row of buttons along the bottom.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Home button</guilabel>
+ </term>
+ <listitem>
+ <para>Activate this button to change the active path to your home folder.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>New Folder button</guilabel>
+ </term>
+ <listitem>
+ <para>Activate this to create a new empty folder as a sub folder of the active path. The new folder will appear in the folder list ready for you to type in the desired name.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Show Hidden check box</guilabel>
+ </term>
+ <listitem>
+ <para>Enabling this check box will cause hidden folders to appear in the folder list.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Bookmark list</guilabel>
+ </term>
+ <listitem>
+ <para>
+ This list on the left side of the window allows you to save links to folders that are frequently used. Activating a bookmark will change the active path to that pointed to by the link. To add items to the bookmark list highlight a folder and press
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>B</keycap>
+ </keycombo>
+ </shortcut>
+ , select “Add bookmark” from the folder's context menu, or drag a folder onto the bookmark list.
+ <para />
+ The bookmark has a context menu that can be displayed by clicking the right mouse button, or pressing the Menu key when a bookmark has the focus. From the context menu you can edit a bookmark, move it up or down in the list, or remove the bookmark from the list. A bookmark can also be moved by pressing Shift + Up or Shift + Down while it has the focus.
+ </para>
+ <para>A bookmark with the name "." is treated as a special case. Each time this bookmark is displayed, its path is loaded with Geeqie's current working folder. This bookmark, like any other, can be deleted and re-created at any time.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Folder list</guilabel>
+ </term>
+ <listitem>
+ <para>
+ This is the list that displays the folders contained in the active path. To change the active path to a folder displayed in this list double click the primary mouse button or highlight the folder with the keyboard and press
+ <keycap>Enter</keycap>
+ or
+ <keycap>Spacebar</keycap>
+ . This list has a context menu that allows renaming or bookmarking the selected folder. A folder can also be dragged onto the bookmark list to add a bookmark.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Path entry</guilabel>
+ </term>
+ <listitem>
+ <para>This text entry displays the active path of the dialog. The path can be directly edited using this entry. Tab completion is supported, and the drop down arrow will display a list of recently selected folders.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Copy/Move button</guilabel>
+ </term>
+ <listitem>
+ <para>The name of this button will differ depending on the selected operation, activating it will start the operation with the folder displayed in the path entry as the destination.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Cancel button</guilabel>
+ </term>
+ <listitem>
+ <para>Activate this button to close the dialog, the operation will be aborted.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Theerrordialog">
+ <title>The error dialog</title>
+ <para>If a problem occurs because Geeqie is unable to Copy or Move a selected file a dialog will appear to notify the user. The dialog will also ask if the operation should continue if one or more files remain to be Copied or Moved.</para>
+ <para />
+ </section>
+ <section id="Theoverwritedialog">
+ <title>The overwrite dialog</title>
+ <para>If a file with the same name exists in the selected destination a dialog will appear to notify the user and ask how to resolve the conflict. The dialog will also display the source and destination images. The following possible solutions will be offered:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Auto rename</guilabel>
+ </term>
+ <listitem>
+ <para>Enabling this check box to have Geeqie select a unique name for the destination file, the proposed new name will appear in the rename entry field.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Rename</guilabel>
+ </term>
+ <listitem>
+ <para>Enable this check box to manually enter a new name for the file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Overwrite</guilabel>
+ </term>
+ <listitem>
+ <para>Activate this will overwrite the existing file, or rename it if one of the rename check boxes are enabled.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Overwrite all</guilabel>
+ </term>
+ <listitem>
+ <para>Activating this will perform the same operation as the Yes button, however any further file name conflicts will be handled quietly in the same method as is selected for the current file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Skip</guilabel>
+ </term>
+ <listitem>
+ <para>This button will skip doing anything to the file in question, and resume the operation with the next file. The source file will remain untouched.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Skip All</guilabel>
+ </term>
+ <listitem>
+ <para>This will perform the same as the Skip button, however any further file name conflicts will be quietly ignored for all remaining files.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Cancel</guilabel>
+ </term>
+ <listitem>
+ <para>This will close the dialog and stop the operation, all remaining files will be ignored.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideImageManagementDelete">\r
- <title>Delete</title>\r
- <para>\r
- To delete a file in Geeqie select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>D</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Delete</guimenuitem>\r
- </menuchoice>\r
- . Delete is also available in the context menu of all images and files. If\r
- <link linkend="Delete">Enable delete key</link>\r
- is enabled in Options, pressing the\r
- <keycap>Delete</keycap>\r
- key can also be used to delete files.\r
- </para>\r
- <para>\r
- The behavior when starting a delete operation depends on the\r
- <link linkend="Delete">Confirm file delete</link>\r
- option in Options. If the option is enabled a dialog will appear to confirm the operation, if it is not enabled the files will be deleted without further interaction. In all cases if the file is unable to be deleted you will be notified by a dialog.\r
- </para>\r
- <para />\r
- <section id="Confirmdeletedialog">\r
- <title>Confirm delete dialog</title>\r
- <para>\r
- The dialog that appears when delete confirmation is enabled will show the file or files to be deleted. To delete the file press\r
- <keycap>Enter</keycap>\r
- or activate the Delete button. Pressing\r
- <keycap>Escape</keycap>\r
- or activating the Cancel button will close the dialog and abort the operation.\r
- </para>\r
- <para>When deleting multiple files, the dialog will include two arrow buttons to step the image preview through the list of files to be deleted. Initially the preview will be blank, activate the right arrow to display the first file.</para>\r
- <para>\r
- The dialog will also display the status of the\r
- <link linkend="Delete">Safe Delete</link>\r
- feature. Use this to determine if a file to be deleted will be immediately lost, or if the file can possibly be recovered from the Safe Delete folder.\r
- </para>\r
- <para>\r
- If a file is unable to be deleted, a dialog will appear to notify you. If multiple files were selected and any remain, the dialog will include a Continue button, activating this button or pressing Enter will delete the remaining files. Pressing\r
- <keycap>Escape</keycap>\r
- or activating the Cancel button will close the dialog and the remaining files will not be deleted.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="SafeDelete">\r
- <title>Safe Delete</title>\r
- <para>\r
- Geeqie includes a feature to temporarily store deleted files in a selected folder, to use this feature enable\r
- <link linkend="Delete">Safe Delete</link>\r
- on the advanced tab of the preferences dialog.\r
- </para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImageManagementDelete">
+ <title>Delete</title>
+ <para>
+ To delete a file in Geeqie select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>D</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Delete</guimenuitem>
+ </menuchoice>
+ . Delete is also available in the context menu of all images and files. If
+ <link linkend="Delete">Enable delete key</link>
+ is enabled in Options, pressing the
+ <keycap>Delete</keycap>
+ key can also be used to delete files.
+ </para>
+ <para>
+ The behavior when starting a delete operation depends on the
+ <link linkend="Delete">Confirm file delete</link>
+ option in Options. If the option is enabled a dialog will appear to confirm the operation, if it is not enabled the files will be deleted without further interaction. In all cases if the file is unable to be deleted you will be notified by a dialog.
+ </para>
+ <para />
+ <section id="Confirmdeletedialog">
+ <title>Confirm delete dialog</title>
+ <para>
+ The dialog that appears when delete confirmation is enabled will show the file or files to be deleted. To delete the file press
+ <keycap>Enter</keycap>
+ or activate the Delete button. Pressing
+ <keycap>Escape</keycap>
+ or activating the Cancel button will close the dialog and abort the operation.
+ </para>
+ <para>When deleting multiple files, the dialog will include two arrow buttons to step the image preview through the list of files to be deleted. Initially the preview will be blank, activate the right arrow to display the first file.</para>
+ <para>
+ The dialog will also display the status of the
+ <link linkend="Delete">Safe Delete</link>
+ feature. Use this to determine if a file to be deleted will be immediately lost, or if the file can possibly be recovered from the Safe Delete folder.
+ </para>
+ <para>
+ If a file is unable to be deleted, a dialog will appear to notify you. If multiple files were selected and any remain, the dialog will include a Continue button, activating this button or pressing Enter will delete the remaining files. Pressing
+ <keycap>Escape</keycap>
+ or activating the Cancel button will close the dialog and the remaining files will not be deleted.
+ </para>
+ <para />
+ </section>
+ <section id="SafeDelete">
+ <title>Safe Delete</title>
+ <para>
+ Geeqie includes a feature to temporarily store deleted files in a selected folder, to use this feature enable
+ <link linkend="Delete">Safe Delete</link>
+ on the advanced tab of the preferences dialog.
+ </para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideImageManagementPlugins">\r
- <title>Plugins</title>\r
- <para>Geeqie provides the facility to execute external commands - any external command may be called via this facility.</para>\r
- <para>Actions may be performed on a single file, or on a set of selected files.</para>\r
- <para>Plugins can do anything from running simple operations like symlink to activating fully featured programs like Gimp. Nor does the action have to be performed on files - you may, for instance, configure a plugin to download images from your digital camera.</para>\r
- <para>\r
- To perform these actions, Geeqie uses standard\r
- <link linkend="GuideReferenceStandards">desktop</link>\r
- files.\r
- </para>\r
- <para>\r
- It is not necessary to understand the details of desktop file specifications because the\r
- <link linkend="GuidePluginsConfig" endterm="titleGuidePluginsConfig" />\r
- dialogue presents you with an easy-to-use template. This dialogue is accessed via\r
- <menuchoice>\r
- <guimenu>Edit</guimenu>\r
- <guimenuitem>Configure Plugins</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <para>\r
- Plugins will appear in the menu\r
- <menuchoice>\r
- <guimenu>Plugins</guimenu>\r
- </menuchoice>\r
- , unless specified otherwise in the desktop file.\r
- </para>\r
- <para />\r
- <para>Commands that are set to display their output in a window will show a dialogue when the command is executed.</para>\r
- <para>The Result dialogue will display the command's text output. If the plugin command will result in multiple runs of the same command for each file, you can use the Stop button to stop Geeqie from executing the command for remaining files.</para>\r
- <para>\r
- Once all commands have completed, or if the Stop button was pressed and the pending command has completed, you can use the Close button, or press\r
- <code>Escape</code>\r
- , to close the Result dialogue. The Result dialogue can not be closed while a command is still running.\r
- </para>\r
- <para>\r
- The supplied standard plugins are described in the\r
- <link linkend="GuideReferenceStandardPlugins">Reference section.</link>\r
- </para>\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideImageManagementPlugins">
+ <title>Plugins</title>
+ <para>Geeqie provides the facility to execute external commands - any external command may be called via this facility.</para>
+ <para>Actions may be performed on a single file, or on a set of selected files.</para>
+ <para>Plugins can do anything from running simple operations like symlink to activating fully featured programs like Gimp. Nor does the action have to be performed on files - you may, for instance, configure a plugin to download images from your digital camera.</para>
+ <para>
+ To perform these actions, Geeqie uses standard
+ <link linkend="GuideReferenceStandards">desktop</link>
+ files.
+ </para>
+ <para>
+ It is not necessary to understand the details of desktop file specifications because the
+ <link linkend="GuidePluginsConfig" endterm="titleGuidePluginsConfig" />
+ dialogue presents you with an easy-to-use template. This dialogue is accessed via
+ <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Configure Plugins</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <para>
+ Plugins will appear in the menu
+ <menuchoice>
+ <guimenu>Plugins</guimenu>
+ </menuchoice>
+ , unless specified otherwise in the desktop file.
+ </para>
+ <para />
+ <para>Commands that are set to display their output in a window will show a dialogue when the command is executed.</para>
+ <para>The Result dialogue will display the command's text output. If the plugin command will result in multiple runs of the same command for each file, you can use the Stop button to stop Geeqie from executing the command for remaining files.</para>
+ <para>
+ Once all commands have completed, or if the Stop button was pressed and the pending command has completed, you can use the Close button, or press
+ <code>Escape</code>
+ , to close the Result dialogue. The Result dialogue can not be closed while a command is still running.
+ </para>
+ <para>
+ The supplied standard plugins are described in the
+ <link linkend="GuideReferenceStandardPlugins">Reference section.</link>
+ </para>
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideImageManagementRename">\r
- <title id="titleGuideImageManagementRename">Rename</title>\r
- <para>\r
- To rename a file in Geeqie select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>R</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Rename</guimenuitem>\r
- </menuchoice>\r
- . Rename is also available in the context menu of all images and files.\r
- </para>\r
- <para>When renaming a file, a dialog will display allowing entry of the new name for the file. The dialog will be different depending on the number of files selected to be renamed. A simple dialog will appear when renaming a single file, however when renaming multiple files the dialog will include a list of the file to be renamed and additional options.</para>\r
- <para />\r
- <section id="Renamesinglefiledialog">\r
- <title>Rename single file dialog</title>\r
- <para>\r
- The dialog that appears when renaming a single file includes an image of the file, an entry to type the new name of the file, a Rename button, and a Cancel button. Type the new name into the text entry and press\r
- <keycap>Enter</keycap>\r
- or activate the Rename button to rename the file. Press\r
- <keycap>Escape</keycap>\r
- or activate the Cancel button to close the dialog and abort renaming the file.\r
- </para>\r
- <para>\r
- When renaming a file and the new name already exists on the file system a dialog will appear showing the renamed and existing files. To overwrite the existing file press\r
- <keycap>Enter</keycap>\r
- or activate the Overwrite button. Press\r
- <keycap>Escape</keycap>\r
- or activate the Cancel button to close the dialog abort renaming the file.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Renamemultiplefilesdialog">\r
- <title>Rename multiple files dialog</title>\r
- <para>The dialog that appears when renaming multiple files includes the list of files to be renamed, a preview image of the active file, an entry to enter the new file name, an auto rename check box, a Rename button, and a Cancel button.</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Manually enter new file names</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- To manually enter the new name of each file, the active file will be displayed in the image preview and it's original name will be displayed above the text entry. To rename the file type the new name and press\r
- <keycap>Enter</keycap>\r
- or activate the Rename button. When a file is successfully renamed it will be removed from the list and the next one will become the active file. After all files have been renamed, the dialog will close.\r
- </para>\r
- <para>Files do not have to be renamed in the order that they appear in the list, highlighting a name in the list will make it become the active file.</para>\r
- <para>\r
- When renaming a file and the new name already exists on the file system a dialog will appear showing the renamed and existing files. To overwrite the existing file press\r
- <keycap>Enter</keycap>\r
- or activate the Overwrite button. Press\r
- <keycap>Escape</keycap>\r
- or activate the Cancel button to return to the original rename dialog, the file that prompted the overwrite dialog will remain active.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Automatic renaming of multiple files</guilabel>\r
- </term>\r
- <listitem>\r
- <para>To automatically rename the files in the list, enable the Auto rename check box. The dialog will change to batch mode for numerical naming of files.</para>\r
- <para>The file name list will change to include a preview column that will show the resulting name of each file. The text entry will change to three entries; the first represents the text that appears in the new names before the number, the second will be the start number to use when incrementing the file number, and the third represents the text to append to the name after the number. The end text should include the file name extension, therefore batch renaming multiple types of files (those with different extensions) all at once is not recommended.</para>\r
- <para>The padding number can be used to change the minimum length of characters to use for the number portion of the new name. When the file number results in fewer characters than the padding size, the result will be padded with leading zeros to fill the remaining space. For example if padding size is 3, a file with the number 24 will appear in the file name as “024”.</para>\r
- <para>The order of the file list can be changed by dragging a name to the desired location within the list. The preview column will update to reflect the new order.</para>\r
- <para>\r
- When the preview of new names is satisfactory, press\r
- <keycap>Enter</keycap>\r
- or activate the Rename button to rename the files to match the name in the preview column. Press\r
- <keycap>Escape</keycap>\r
- or activate the Cancel button to close the dialog and abort the rename operation.\r
- </para>\r
- <para>If the resulting new names match any existing files, a warning dialog will notify you. The rename dialog will remain so that you can select a different set of names.</para>\r
- <para />\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Formatted renaming of multiple files</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Formatted rename permits file to be renamed in a pre-determined way whilst still including the original file name.</para>\r
- <para>\r
- In the Format box any alpha-numerics can be entered, but the special character\r
- <keycap>*</keycap>\r
- will be replaced by the current filename. One or more\r
- <keycap>#</keycap>\r
- characters can be included, and will be replaced by an incrementing number.\r
- </para>\r
- <para>The current file extension is automatically appended to new new file name.</para>\r
- <para>The order of the file list can be changed by dragging a name to the desired location within the list. The preview column will update to reflect the new order.</para>\r
- <para>When the preview of new names is satisfactory, press Enter or activate the Rename button to rename the files to match the name in the preview column. Press Escape or activate the Cancel button to close the dialog and abort the rename operation.</para>\r
- <para>If the resulting new names match any existing files, a warning dialog will notify you. The rename dialog will remain so that you can select a different set of names.</para>\r
- <para />\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImageManagementRename">
+ <title id="titleGuideImageManagementRename">Rename</title>
+ <para>
+ To rename a file in Geeqie select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>R</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Rename</guimenuitem>
+ </menuchoice>
+ . Rename is also available in the context menu of all images and files.
+ </para>
+ <para>When renaming a file, a dialog will display allowing entry of the new name for the file. The dialog will be different depending on the number of files selected to be renamed. A simple dialog will appear when renaming a single file, however when renaming multiple files the dialog will include a list of the file to be renamed and additional options.</para>
+ <para />
+ <section id="Renamesinglefiledialog">
+ <title>Rename single file dialog</title>
+ <para>
+ The dialog that appears when renaming a single file includes an image of the file, an entry to type the new name of the file, a Rename button, and a Cancel button. Type the new name into the text entry and press
+ <keycap>Enter</keycap>
+ or activate the Rename button to rename the file. Press
+ <keycap>Escape</keycap>
+ or activate the Cancel button to close the dialog and abort renaming the file.
+ </para>
+ <para>
+ When renaming a file and the new name already exists on the file system a dialog will appear showing the renamed and existing files. To overwrite the existing file press
+ <keycap>Enter</keycap>
+ or activate the Overwrite button. Press
+ <keycap>Escape</keycap>
+ or activate the Cancel button to close the dialog abort renaming the file.
+ </para>
+ <para />
+ </section>
+ <section id="Renamemultiplefilesdialog">
+ <title>Rename multiple files dialog</title>
+ <para>The dialog that appears when renaming multiple files includes the list of files to be renamed, a preview image of the active file, an entry to enter the new file name, an auto rename check box, a Rename button, and a Cancel button.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Manually enter new file names</guilabel>
+ </term>
+ <listitem>
+ <para>
+ To manually enter the new name of each file, the active file will be displayed in the image preview and it's original name will be displayed above the text entry. To rename the file type the new name and press
+ <keycap>Enter</keycap>
+ or activate the Rename button. When a file is successfully renamed it will be removed from the list and the next one will become the active file. After all files have been renamed, the dialog will close.
+ </para>
+ <para>Files do not have to be renamed in the order that they appear in the list, highlighting a name in the list will make it become the active file.</para>
+ <para>
+ When renaming a file and the new name already exists on the file system a dialog will appear showing the renamed and existing files. To overwrite the existing file press
+ <keycap>Enter</keycap>
+ or activate the Overwrite button. Press
+ <keycap>Escape</keycap>
+ or activate the Cancel button to return to the original rename dialog, the file that prompted the overwrite dialog will remain active.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Automatic renaming of multiple files</guilabel>
+ </term>
+ <listitem>
+ <para>To automatically rename the files in the list, enable the Auto rename check box. The dialog will change to batch mode for numerical naming of files.</para>
+ <para>The file name list will change to include a preview column that will show the resulting name of each file. The text entry will change to three entries; the first represents the text that appears in the new names before the number, the second will be the start number to use when incrementing the file number, and the third represents the text to append to the name after the number. The end text should include the file name extension, therefore batch renaming multiple types of files (those with different extensions) all at once is not recommended.</para>
+ <para>The padding number can be used to change the minimum length of characters to use for the number portion of the new name. When the file number results in fewer characters than the padding size, the result will be padded with leading zeros to fill the remaining space. For example if padding size is 3, a file with the number 24 will appear in the file name as “024”.</para>
+ <para>The order of the file list can be changed by dragging a name to the desired location within the list. The preview column will update to reflect the new order.</para>
+ <para>
+ When the preview of new names is satisfactory, press
+ <keycap>Enter</keycap>
+ or activate the Rename button to rename the files to match the name in the preview column. Press
+ <keycap>Escape</keycap>
+ or activate the Cancel button to close the dialog and abort the rename operation.
+ </para>
+ <para>If the resulting new names match any existing files, a warning dialog will notify you. The rename dialog will remain so that you can select a different set of names.</para>
+ <para />
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Formatted renaming of multiple files</guilabel>
+ </term>
+ <listitem>
+ <para>Formatted rename permits file to be renamed in a pre-determined way whilst still including the original file name.</para>
+ <para>
+ In the Format box any alpha-numerics can be entered, but the special character
+ <keycap>*</keycap>
+ will be replaced by the current filename. One or more
+ <keycap>#</keycap>
+ characters can be included, and will be replaced by an incrementing number.
+ </para>
+ <para>The current file extension is automatically appended to new new file name.</para>
+ <para>The order of the file list can be changed by dragging a name to the desired location within the list. The preview column will update to reflect the new order.</para>
+ <para>When the preview of new names is satisfactory, press Enter or activate the Rename button to rename the files to match the name in the preview column. Press Escape or activate the Cancel button to close the dialog and abort the rename operation.</para>
+ <para>If the resulting new names match any existing files, a warning dialog will notify you. The rename dialog will remain so that you can select a different set of names.</para>
+ <para />
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideImageMarks">\r
- <title id="titleGuideImageMarks">Marking Images</title>\r
- <para>Marks are intended as a temporary method of grouping and filtering sets of images.</para>\r
- <para>\r
- <link linkend="Keywords" endterm="titleKeywords" />\r
- are intended as a permanent method of identifying sets of images, and to this end it is possible to link any mark with any keyword.\r
- </para>\r
- <para>\r
- The\r
- <guimenu>Select</guimenu>\r
- menu gives access to the marks operations of setting, filtering and intersection.\r
- </para>\r
- <para>There are 10 individual marks, any of which can be associated with an image simply by pressing the 0 to 9 keys on the keyboard, where key 0 represents mark 10.</para>\r
- <para>\r
- If the\r
- <guimenu>Show Marks</guimenu>\r
- menu has been selected, each image will have a set of 10 check-boxes displayed adjacent to it in the file pane in both icon and list mode. In addition a set of 10 check-boxes will be shown at the top of the files pane. Clicking any of these will filter the displayed list.\r
- </para>\r
- <para>Moving the mouse over any of the check-boxes at the top of the files pane will show mnemonic text for that mark. The text can be modified by right-clicking on the check box.</para>\r
- <para>\r
- If the\r
- <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />\r
- is being displayed, the currently set marks for the image are shown. It is not necessary to include an entry into the overlay template for this to happen.\r
- </para>\r
- <para>\r
- A keyword can be associated with a single mark by right-clicking on the keyword in the sidebar panel. When a meta-data write operation for a file is triggered either\r
- <link linkend="Buttons">manually</link>\r
- or as defined in\r
- <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />\r
- , the keyword data indicated by the current set of mark-to-keyword links will be written.\r
- </para>\r
- <para>\r
- The associations between keywords and marks is preserved when Geeqie is shut down. The current setting of marks can also be optionally saved - the setting is in the\r
- <link linkend="Behaviour">Behavior tab of Preferences</link>\r
- .\r
- </para>\r
- <para />\r
- <para />\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImageMarks">
+ <title id="titleGuideImageMarks">Marking Images</title>
+ <para>Marks are intended as a temporary method of grouping and filtering sets of images.</para>
+ <para>
+ <link linkend="Keywords" endterm="titleKeywords" />
+ are intended as a permanent method of identifying sets of images, and to this end it is possible to link any mark with any keyword.
+ </para>
+ <para>
+ The
+ <guimenu>Select</guimenu>
+ menu gives access to the marks operations of setting, filtering and intersection.
+ </para>
+ <para>There are 10 individual marks, any of which can be associated with an image simply by pressing the 0 to 9 keys on the keyboard, where key 0 represents mark 10.</para>
+ <para>
+ If the
+ <guimenu>Show Marks</guimenu>
+ menu has been selected, each image will have a set of 10 check-boxes displayed adjacent to it in the file pane in both icon and list mode. In addition a set of 10 check-boxes will be shown at the top of the files pane. Clicking any of these will filter the displayed list.
+ </para>
+ <para>Moving the mouse over any of the check-boxes at the top of the files pane will show mnemonic text for that mark. The text can be modified by right-clicking on the check box.</para>
+ <para>
+ If the
+ <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />
+ is being displayed, the currently set marks for the image are shown. It is not necessary to include an entry into the overlay template for this to happen.
+ </para>
+ <para>
+ A keyword can be associated with a single mark by right-clicking on the keyword in the sidebar panel. When a meta-data write operation for a file is triggered either
+ <link linkend="Buttons">manually</link>
+ or as defined in
+ <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />
+ , the keyword data indicated by the current set of mark-to-keyword links will be written.
+ </para>
+ <para>
+ The associations between keywords and marks is preserved when Geeqie is shut down. The current setting of marks can also be optionally saved - the setting is in the
+ <link linkend="Behaviour">Behavior tab of Preferences</link>
+ .
+ </para>
+ <para />
+ <para />
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideImagePresentationFullscreen">\r
- <title id="titleGuideImagePresentationFullscreen">Full Screen</title>\r
- <para>Geeqie allows for the image pane to be expanded to fill the entire screen, this is referred to as full screen.</para>\r
- <para />\r
- <section id="Turningonfullscreen">\r
- <title>Turning on full screen</title>\r
- <para>Full screen can be activated in a number of ways:</para>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>F</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>View</guimenu>\r
- <guimenuitem>Full screen</guimenuitem>\r
- </menuchoice>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- From a context menu - right click an image pane, and select\r
- <emphasis role="strong">Full screen</emphasis>\r
- .\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="Turningofffullscreen">\r
- <title>Turning off full screen</title>\r
- <para>To return to the normal view:</para>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>\r
- From the keyboard - press\r
- <keycap>F</keycap>\r
- or\r
- <keycap>Esc</keycap>\r
- to stop full screen.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- From a context menu - right click the image pane, and select\r
- <emphasis role="strong">Exit full screen</emphasis>\r
- .\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- From the menu bar - the menu bar may be visible when using multiple monitors, select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>F</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>View</guimenu>\r
- <guimenuitem>Full screen</guimenuitem>\r
- </menuchoice>\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="Configuringfullscreen">\r
- <title>Configuring full screen</title>\r
- <para>\r
- Full screen behavior and location can be adjusted on the\r
- <link linkend="FullScreen">Windows tab</link>\r
- of the preferences dialog.\r
- </para>\r
- </section>\r
- <section id="Navigation">\r
- <title>Navigation</title>\r
- <para>\r
- Refer to\r
- <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />\r
- .\r
- </para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImagePresentationFullscreen">
+ <title id="titleGuideImagePresentationFullscreen">Full Screen</title>
+ <para>Geeqie allows for the image pane to be expanded to fill the entire screen, this is referred to as full screen.</para>
+ <para />
+ <section id="Turningonfullscreen">
+ <title>Turning on full screen</title>
+ <para>Full screen can be activated in a number of ways:</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>F</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>Full screen</guimenuitem>
+ </menuchoice>
+ </listitem>
+ <listitem>
+ <para>
+ From a context menu - right click an image pane, and select
+ <emphasis role="strong">Full screen</emphasis>
+ .
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="Turningofffullscreen">
+ <title>Turning off full screen</title>
+ <para>To return to the normal view:</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ From the keyboard - press
+ <keycap>F</keycap>
+ or
+ <keycap>Esc</keycap>
+ to stop full screen.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ From a context menu - right click the image pane, and select
+ <emphasis role="strong">Exit full screen</emphasis>
+ .
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ From the menu bar - the menu bar may be visible when using multiple monitors, select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>F</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>Full screen</guimenuitem>
+ </menuchoice>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="Configuringfullscreen">
+ <title>Configuring full screen</title>
+ <para>
+ Full screen behavior and location can be adjusted on the
+ <link linkend="FullScreen">Windows tab</link>
+ of the preferences dialog.
+ </para>
+ </section>
+ <section id="Navigation">
+ <title>Navigation</title>
+ <para>
+ Refer to
+ <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />
+ .
+ </para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideImagePresentationSlideshow">\r
- <title id="titleGuideImagePresentationSlideshow">Slide Show</title>\r
- <para>The image pane can be set to automatically change the displayed image after a period of time, in Geeqie this is referred to as a slide show.</para>\r
- <para />\r
- <section id="Startingaslideshow">\r
- <title>Starting a slide show</title>\r
- <para>A slide show can be started in a number of ways:</para>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>\r
- From the keyboard or mouse\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>S</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>View</guimenu>\r
- <guimenuitem>Toggle slide show</guimenuitem>\r
- </menuchoice>\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- From a context menu - right click an image pane, and select\r
- <emphasis role="strong">Start slide show</emphasis>\r
- , or\r
- <emphasis role="strong">Stop slide show</emphasis>\r
- ; the text will change depending on the state of the current slide show.\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="Stoppingaslideshow">\r
- <title>Stopping a slide show</title>\r
- <para>\r
- An active slide show can be stopped by using the same functions available to start one, as they work like a toggle switch. If slide show repeat is not enabled in the\r
- <link linkend="GuideOptionsGeneral">Preferences dialog</link>\r
- , the slide show will stop when the last image in the sequence is displayed.\r
- </para>\r
- <para>\r
- Any action that changes the image pane to a new image will stop the active slide show, with the exception of the methods discussed in\r
- <link linkend="Slideshowsequencenavigation">Slide show sequence navigation</link>\r
- .\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Slideshowstatus">\r
- <title>Slide show status</title>\r
- <para>\r
- The main window\r
- <link linkend="GuideMainWindowStatusBar">status bar</link>\r
- can be used to determine when a slide show is active,\r
- <emphasis role="strong">Slide show</emphasis>\r
- will be displayed next to the file count field. An individual\r
- <link linkend="GuideOtherWindowsImageWindow">Image Window</link>\r
- can also display a slide show, however the status will not be immediately visible. To determine the slide show status in an image window, open a context menu by right clicking or using the menu key, the slide show menu item will reflect the slide show status; if\r
- <emphasis role="strong">Start slide show</emphasis>\r
- is displayed, no slide show is active, conversely if\r
- <emphasis role="strong">Stop slide show</emphasis>\r
- is displayed a slide show is active.\r
- </para>\r
- <para>\r
- When a Slide show is paused, the main window status bar will display\r
- <emphasis role="strong">Paused</emphasis>\r
- instead of\r
- <emphasis role="strong">Slide show</emphasis>\r
- . Likewise, the image context menu will display\r
- <emphasis role="strong">Pause slide show</emphasis>\r
- or\r
- <emphasis role="strong">Continue slide show</emphasis>\r
- , depending on the current state.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Pausingaslideshow">\r
- <title>Pausing a slide show</title>\r
- <para>An active slide show can be paused in two ways:</para>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>\r
- From the keyboard - press the\r
- <keycap>P</keycap>\r
- key while a slide show is active.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- From a context menu - right click the image pane displaying the slide show, and select\r
- <emphasis role="strong">Pause slide show</emphasis>\r
- , or\r
- <emphasis role="strong">Continue slide show</emphasis>\r
- depending on the current slide show state.\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="Selectingtheimagestoincludeinaslideshow">\r
- <title>Selecting the images to include in a slide show</title>\r
- <para>When a single image is selected, all images in the current folder are included in the slide show. The sequence will begin with the current image; however if random slide shows are enabled, the sequence will begin with a random image from the list.</para>\r
- <para>To only include some images in a slide show, use multiple selection to select the images to include before starting the slide show.</para>\r
- <para>An image collection can be used as the list of images, to do this drag an image from a collection window onto the image pane. Starting a slide show will then include the images from that collection.</para>\r
- <para>\r
- So far, the methods described are for slide shows in a main window, in an\r
- <link linkend="GuideOtherWindowsImageWindow">Image Window</link>\r
- , the slide show will use all images referenced by that window.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Recursiveslideshow">\r
- <title>Recursive slide show</title>\r
- <para>In the main window, a recursive slide show can be started from a folder's context menu; the folder's right click menu will include two slide show options:</para>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>Slide show: This will start a slide show that includes all images in the selected folder.</para>\r
- </listitem>\r
- <listitem>\r
- <para>Slide show recursive: The slide show will include all images in the selected folder, and all images in the folders that are contained within the selected folder.</para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="Slideshowsequencenavigation">\r
- <title>Slide show sequence navigation</title>\r
- <para>When a slide show is active, functions that normally change the image forward and backward can be used to step through those contained in the slide show.</para>\r
- <para />\r
- </section>\r
- <section id="Configuringaslideshow">\r
- <title>Configuring a slide show</title>\r
- <para>\r
- The options that control the behavior of slide shows are located on the\r
- <link linkend="Slideshow">General tab</link>\r
- of the options dialog.\r
- </para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImagePresentationSlideshow">
+ <title id="titleGuideImagePresentationSlideshow">Slide Show</title>
+ <para>The image pane can be set to automatically change the displayed image after a period of time, in Geeqie this is referred to as a slide show.</para>
+ <para />
+ <section id="Startingaslideshow">
+ <title>Starting a slide show</title>
+ <para>A slide show can be started in a number of ways:</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ From the keyboard or mouse
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>S</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>Toggle slide show</guimenuitem>
+ </menuchoice>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ From a context menu - right click an image pane, and select
+ <emphasis role="strong">Start slide show</emphasis>
+ , or
+ <emphasis role="strong">Stop slide show</emphasis>
+ ; the text will change depending on the state of the current slide show.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="Stoppingaslideshow">
+ <title>Stopping a slide show</title>
+ <para>
+ An active slide show can be stopped by using the same functions available to start one, as they work like a toggle switch. If slide show repeat is not enabled in the
+ <link linkend="GuideOptionsGeneral">Preferences dialog</link>
+ , the slide show will stop when the last image in the sequence is displayed.
+ </para>
+ <para>
+ Any action that changes the image pane to a new image will stop the active slide show, with the exception of the methods discussed in
+ <link linkend="Slideshowsequencenavigation">Slide show sequence navigation</link>
+ .
+ </para>
+ <para />
+ </section>
+ <section id="Slideshowstatus">
+ <title>Slide show status</title>
+ <para>
+ The main window
+ <link linkend="GuideMainWindowStatusBar">status bar</link>
+ can be used to determine when a slide show is active,
+ <emphasis role="strong">Slide show</emphasis>
+ will be displayed next to the file count field. An individual
+ <link linkend="GuideOtherWindowsImageWindow">Image Window</link>
+ can also display a slide show, however the status will not be immediately visible. To determine the slide show status in an image window, open a context menu by right clicking or using the menu key, the slide show menu item will reflect the slide show status; if
+ <emphasis role="strong">Start slide show</emphasis>
+ is displayed, no slide show is active, conversely if
+ <emphasis role="strong">Stop slide show</emphasis>
+ is displayed a slide show is active.
+ </para>
+ <para>
+ When a Slide show is paused, the main window status bar will display
+ <emphasis role="strong">Paused</emphasis>
+ instead of
+ <emphasis role="strong">Slide show</emphasis>
+ . Likewise, the image context menu will display
+ <emphasis role="strong">Pause slide show</emphasis>
+ or
+ <emphasis role="strong">Continue slide show</emphasis>
+ , depending on the current state.
+ </para>
+ <para />
+ </section>
+ <section id="Pausingaslideshow">
+ <title>Pausing a slide show</title>
+ <para>An active slide show can be paused in two ways:</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ From the keyboard - press the
+ <keycap>P</keycap>
+ key while a slide show is active.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ From a context menu - right click the image pane displaying the slide show, and select
+ <emphasis role="strong">Pause slide show</emphasis>
+ , or
+ <emphasis role="strong">Continue slide show</emphasis>
+ depending on the current slide show state.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="Selectingtheimagestoincludeinaslideshow">
+ <title>Selecting the images to include in a slide show</title>
+ <para>When a single image is selected, all images in the current folder are included in the slide show. The sequence will begin with the current image; however if random slide shows are enabled, the sequence will begin with a random image from the list.</para>
+ <para>To only include some images in a slide show, use multiple selection to select the images to include before starting the slide show.</para>
+ <para>An image collection can be used as the list of images, to do this drag an image from a collection window onto the image pane. Starting a slide show will then include the images from that collection.</para>
+ <para>
+ So far, the methods described are for slide shows in a main window, in an
+ <link linkend="GuideOtherWindowsImageWindow">Image Window</link>
+ , the slide show will use all images referenced by that window.
+ </para>
+ <para />
+ </section>
+ <section id="Recursiveslideshow">
+ <title>Recursive slide show</title>
+ <para>In the main window, a recursive slide show can be started from a folder's context menu; the folder's right click menu will include two slide show options:</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Slide show: This will start a slide show that includes all images in the selected folder.</para>
+ </listitem>
+ <listitem>
+ <para>Slide show recursive: The slide show will include all images in the selected folder, and all images in the folders that are contained within the selected folder.</para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="Slideshowsequencenavigation">
+ <title>Slide show sequence navigation</title>
+ <para>When a slide show is active, functions that normally change the image forward and backward can be used to step through those contained in the slide show.</para>
+ <para />
+ </section>
+ <section id="Configuringaslideshow">
+ <title>Configuring a slide show</title>
+ <para>
+ The options that control the behavior of slide shows are located on the
+ <link linkend="Slideshow">General tab</link>
+ of the options dialog.
+ </para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideImageSearch">\r
- <title id="titleGuideImageSearch">Search and Select</title>\r
- <para>Geeqie provides comprehensive set of search methods, including not only the standard functions such as file date or size, but also image similarity.</para>\r
- <para>There is a duplicate file finder, which uses search parameters such as image dimensions or checksum. Two sets of image files may be compared.</para>\r
- <para>Geeqie also has a set of temporary "marks" or "tags" which may be allocated to any image as an aide to file organising.</para>\r
- <section id="GuideImageSearchCache">\r
- <title id="titleGuideImageSearchCache">Caching Data For Searches</title>\r
- <para>\r
- Searching large numbers of files for similarity can take significant cpu time. Part of this is the time to compute the similarity matrix for each file.\r
- <para />\r
- If the\r
- <link linkend="PreferencesThumbnails">Cache Thumbnails</link>\r
- option is selected in Preferences/General, the similarity matrix, checksum, image size and Exif Date may also be cached. This will reduce the time needed for future searches.\r
- <note>\r
- If you frequently search on similarity and your images are in a tree arrangement under a single point, the\r
- <link linkend="CreateSimFiles">Create file similarity cache</link>\r
- from the top of the tree will generate the similarity data for all images.\r
- </note>\r
- <para>Similarity data are stored in a folder hierarchy that mirrors the location of the source images. The data have the same name as the original appended by the file extension .sim.</para>\r
- <para>\r
- The root of the hierarchy is:\r
- <para>\r
- <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>\r
- or, if $XDG_CACHE_HOME is not defined:\r
- <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>\r
- </para>\r
- </para>\r
- </para>\r
- <para />\r
- </section>\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchSearch.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchFindingDuplicates.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageMarks.xml" />\r
- <para />\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideImageSearch">
+ <title id="titleGuideImageSearch">Search and Select</title>
+ <para>Geeqie provides comprehensive set of search methods, including not only the standard functions such as file date or size, but also image similarity.</para>
+ <para>There is a duplicate file finder, which uses search parameters such as image dimensions or checksum. Two sets of image files may be compared.</para>
+ <para>Geeqie also has a set of temporary "marks" or "tags" which may be allocated to any image as an aide to file organising.</para>
+ <section id="GuideImageSearchCache">
+ <title id="titleGuideImageSearchCache">Caching Data For Searches</title>
+ <para>
+ Searching large numbers of files for similarity can take significant cpu time. Part of this is the time to compute the similarity matrix for each file.
+ <para />
+ If the
+ <link linkend="PreferencesThumbnails">Cache Thumbnails</link>
+ option is selected in Preferences/General, the similarity matrix, checksum, image size and Exif Date may also be cached. This will reduce the time needed for future searches.
+ <note>
+ If you frequently search on similarity and your images are in a tree arrangement under a single point, the
+ <link linkend="CreateSimFiles">Create file similarity cache</link>
+ from the top of the tree will generate the similarity data for all images.
+ </note>
+ <para>Similarity data are stored in a folder hierarchy that mirrors the location of the source images. The data have the same name as the original appended by the file extension .sim.</para>
+ <para>
+ The root of the hierarchy is:
+ <para>
+ <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>
+ or, if $XDG_CACHE_HOME is not defined:
+ <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>
+ </para>
+ </para>
+ </para>
+ <para />
+ </section>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchSearch.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearchFindingDuplicates.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageMarks.xml" />
+ <para />
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideImageSearchFindingDuplicates">\r
- <title id="titleGuideImageSearchFindingDuplicates">Finding Duplicates</title>\r
- <para>Geeqie provides a utility to find images that have similar attributes or content.</para>\r
- <para>\r
- To display a new Find Duplicates Window select\r
- <menuchoice>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Find duplicates</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <section id="Addingfilestobecompared">\r
- <title>Adding files to be compared</title>\r
- <para>Add files to be compared using drag and drop. Drop files or folders onto the Find Duplicates window to add them to the list of files to compare. When one or more folders are dropped onto the window a menu will appear allowing you to choose the desired action:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Add contents</guilabel>\r
- </term>\r
- <listitem>The contents of dropped folders will added to the window.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Add contents recursive</guilabel>\r
- </term>\r
- <listitem>The contents of dropped folders and all sub folders will be added to the window.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Skip folders</guilabel>\r
- </term>\r
- <listitem>\r
- Ignore folders contained in the drop list.\r
- <para />\r
- When files are added to the window, the comparison is restarted to include the new files.\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para>\r
- <note>\r
- <para>Symbolic links to folders will be followed, but symbolic links to files will be ignored. Only actual files will be tested.</para>\r
- </note>\r
- </para>\r
- </section>\r
- <section id="Comparisonmethods">\r
- <title>Comparison methods</title>\r
- <para>\r
- The attribute to use for two images to match can be selected with the\r
- <emphasis role="bold">Compare by:</emphasis>\r
- drop down menu. Each method is explained below:\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Name</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The file name.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Name case-insensitive</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The file name but ignoring case.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The file size.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Date</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The file date.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Dimensions</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The image dimensions.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Checksum</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The MD5 file checksum.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Path</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The complete path to file.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Similarity (high)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Very similar image content. Preset to 95%.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Similarity</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Similar image content. Preset to 90%.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Similarity (low)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Slightly similar image content. Preset to 85%.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Similarity (custom)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- The percentage value to used to consider two images a match is configured in the spin box at the bottom of the window. Setting a value to less than 85 is not likely to be useful.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Name ≠ Content</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Show images with the same name but different content.\r
- <note>\r
- <para>Because pairs of files are being compared, when there are multiple hits care should be taken when analyzing the results.</para>\r
- </note>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Name case-insensitive ≠ Content</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Show images with the same name, ignoring case, but different content.\r
- <note>\r
- <para>Because pairs of files are being compared, when there are multiple hits care should be taken when analyzing the results.</para>\r
- </note>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Show all</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Do not compare. Show all images.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Resultslist">\r
- <title>Results list</title>\r
- <para>Files that match with the selected comparison method will appear in the list. Matching files are grouped in alternating color.</para>\r
- <para>The order of the result list can be changed by clicking on the column header. This will re-order the images within each set. When comparing by image content similarity, the matching sets will be sorted by order of rank starting with the files that are most similar.</para>\r
- <para>\r
- A\r
- <emphasis role="strong">context menu</emphasis>\r
- is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus.\r
- </para>\r
- <para>\r
- Groups in the results list may be selected by using the keyboard. Refer to the <emphasis>Find Duplicates Window</emphasis> section of\r
- <link linkend="DuplicatesKeyboardShortcuts" >Keyboard Shortcuts</link>\r
- .\r
- </para>\r
- <para>\r
- The\r
- <emphasis role="strong">selection</emphasis>\r
- can be changed using the keyboard and mouse the same as in a\r
- <link linkend="GuideMainWindowFilePane">file pane</link>\r
- of the main window.\r
- </para>\r
- <para>The image Dimensions column of the result list will only contain dimension information when comparing by dimensions, or when the data is easily available from memory or has been read from the cache.</para>\r
- </section>\r
- <section id="Statusbar">\r
- <title>Status bar</title>\r
- <para>Along the bottom of the Find Duplicates window is an area that displays the count of files contained in the window, and the number of files in the result list.</para>\r
- <para>The status bar will also display the status of an active compare operation using the progress bar. A compare operation involves 2 or 3 stages, depending on the type of comparison. These are the stages in order:</para>\r
- <orderedlist>\r
- <listitem>\r
- <para>If necessary, extra data is read into memory for the comparison stage and the progress bar will indicate this stage with text such as “Reading dimensions...”, “Reading checksums...”, or “Reading similarity data...”.</para>\r
- </listitem>\r
- <listitem>The images are compared using the selected method, the progress bar will indicate this stage with the text “Comparing...”.</listitem>\r
- <listitem>\r
- <para>The results are sorted for display, the progress bar will indicate this stage with the text “Sorting...”.</para>\r
- <para>Stage 1 is only used for the Dimensions, Checksum, and Similarity compare methods.</para>\r
- <para>If the time to complete a stage will be significant, an estimated time to completion will also be displayed in the progress bar. The estimated time only refers to the current stage, other stages are not included in the estimate. The time estimate is displayed using the format MINUTES:SECONDS.</para>\r
- </listitem>\r
- </orderedlist>\r
- </section>\r
- <section id="Thumbnails">\r
- <title>Thumbnails</title>\r
- <para>Thumbnails can be displayed beside each image in the result list by enabling the Thumbnails check box.</para>\r
- </section>\r
- <section id="Orientation">\r
- <title>Ignore Orientation</title>\r
- <para>When selected and a similarity compare is being used, the images are checked against 4 rotations: 0°, 90°, 180°, 270°, plus flip and mirror.</para>\r
- </section>\r
- <section id="Sort">\r
- <title>Sort</title>\r
- <para>\r
- The normal sort order is for groups (in the case of Similarity checks) with the highest number of near-100% matches to be at the top of the list.\r
- <para />\r
- If this box is checked, groups with the lowest number of matches are placed at the top of the list.\r
- </para>\r
- </section>\r
- <section id="Comparetwofilesets">\r
- <title>Compare two file sets</title>\r
- <para>Sometimes it is useful to compare one group of files to another, different group of files. Enable this check box to compare two groups of files. When enabled, a second list will appear and files can be added to this list using the same methods for the main list.</para>\r
- <para>When comparing two file sets the results list will display matches between the two lists. For each match group, the first file is always from the main group, and the remaining files are always from the second group.</para>\r
- </section>\r
- <section id="DragandDrop">\r
- <title>Drag and Drop</title>\r
- <para>Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</para>\r
- </section>\r
- <section id="ImageDataWindow">\r
- <title>Image Data Window</title>\r
- <para>\r
- <code>Ctrl+Shift+Right Mouse click</code>\r
- : Use this to display a dialog containing the data stored for the clicked image file. This is usually only useful for debugging purposes.\r
- </para>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImageSearchFindingDuplicates">
+ <title id="titleGuideImageSearchFindingDuplicates">Finding Duplicates</title>
+ <para>Geeqie provides a utility to find images that have similar attributes or content.</para>
+ <para>
+ To display a new Find Duplicates Window select
+ <menuchoice>
+ <guimenu>File</guimenu>
+ <guimenuitem>Find duplicates</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <section id="Addingfilestobecompared">
+ <title>Adding files to be compared</title>
+ <para>Add files to be compared using drag and drop. Drop files or folders onto the Find Duplicates window to add them to the list of files to compare. When one or more folders are dropped onto the window a menu will appear allowing you to choose the desired action:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Add contents</guilabel>
+ </term>
+ <listitem>The contents of dropped folders will added to the window.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Add contents recursive</guilabel>
+ </term>
+ <listitem>The contents of dropped folders and all sub folders will be added to the window.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Skip folders</guilabel>
+ </term>
+ <listitem>
+ Ignore folders contained in the drop list.
+ <para />
+ When files are added to the window, the comparison is restarted to include the new files.
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>
+ <note>
+ <para>Symbolic links to folders will be followed, but symbolic links to files will be ignored. Only actual files will be tested.</para>
+ </note>
+ </para>
+ </section>
+ <section id="Comparisonmethods">
+ <title>Comparison methods</title>
+ <para>
+ The attribute to use for two images to match can be selected with the
+ <emphasis role="bold">Compare by:</emphasis>
+ drop down menu. Each method is explained below:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Name</guilabel>
+ </term>
+ <listitem>
+ <para>The file name.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Name case-insensitive</guilabel>
+ </term>
+ <listitem>
+ <para>The file name but ignoring case.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Size</guilabel>
+ </term>
+ <listitem>
+ <para>The file size.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Date</guilabel>
+ </term>
+ <listitem>
+ <para>The file date.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Dimensions</guilabel>
+ </term>
+ <listitem>
+ <para>The image dimensions.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Checksum</guilabel>
+ </term>
+ <listitem>
+ <para>The MD5 file checksum.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Path</guilabel>
+ </term>
+ <listitem>
+ <para>The complete path to file.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Similarity (high)</guilabel>
+ </term>
+ <listitem>
+ <para>Very similar image content. Preset to 95%.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Similarity</guilabel>
+ </term>
+ <listitem>
+ <para>Similar image content. Preset to 90%.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Similarity (low)</guilabel>
+ </term>
+ <listitem>
+ <para>Slightly similar image content. Preset to 85%.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Similarity (custom)</guilabel>
+ </term>
+ <listitem>
+ <para>
+ The percentage value to used to consider two images a match is configured in the spin box at the bottom of the window. Setting a value to less than 85 is not likely to be useful.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Name ≠ Content</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Show images with the same name but different content.
+ <note>
+ <para>Because pairs of files are being compared, when there are multiple hits care should be taken when analyzing the results.</para>
+ </note>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Name case-insensitive ≠ Content</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Show images with the same name, ignoring case, but different content.
+ <note>
+ <para>Because pairs of files are being compared, when there are multiple hits care should be taken when analyzing the results.</para>
+ </note>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Show all</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Do not compare. Show all images.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Resultslist">
+ <title>Results list</title>
+ <para>Files that match with the selected comparison method will appear in the list. Matching files are grouped in alternating color.</para>
+ <para>The order of the result list can be changed by clicking on the column header. This will re-order the images within each set. When comparing by image content similarity, the matching sets will be sorted by order of rank starting with the files that are most similar.</para>
+ <para>
+ A
+ <emphasis role="strong">context menu</emphasis>
+ is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus.
+ </para>
+ <para>
+ Groups in the results list may be selected by using the keyboard. Refer to the <emphasis>Find Duplicates Window</emphasis> section of
+ <link linkend="DuplicatesKeyboardShortcuts" >Keyboard Shortcuts</link>
+ .
+ </para>
+ <para>
+ The
+ <emphasis role="strong">selection</emphasis>
+ can be changed using the keyboard and mouse the same as in a
+ <link linkend="GuideMainWindowFilePane">file pane</link>
+ of the main window.
+ </para>
+ <para>The image Dimensions column of the result list will only contain dimension information when comparing by dimensions, or when the data is easily available from memory or has been read from the cache.</para>
+ </section>
+ <section id="Statusbar">
+ <title>Status bar</title>
+ <para>Along the bottom of the Find Duplicates window is an area that displays the count of files contained in the window, and the number of files in the result list.</para>
+ <para>The status bar will also display the status of an active compare operation using the progress bar. A compare operation involves 2 or 3 stages, depending on the type of comparison. These are the stages in order:</para>
+ <orderedlist>
+ <listitem>
+ <para>If necessary, extra data is read into memory for the comparison stage and the progress bar will indicate this stage with text such as “Reading dimensions...”, “Reading checksums...”, or “Reading similarity data...”.</para>
+ </listitem>
+ <listitem>The images are compared using the selected method, the progress bar will indicate this stage with the text “Comparing...”.</listitem>
+ <listitem>
+ <para>The results are sorted for display, the progress bar will indicate this stage with the text “Sorting...”.</para>
+ <para>Stage 1 is only used for the Dimensions, Checksum, and Similarity compare methods.</para>
+ <para>If the time to complete a stage will be significant, an estimated time to completion will also be displayed in the progress bar. The estimated time only refers to the current stage, other stages are not included in the estimate. The time estimate is displayed using the format MINUTES:SECONDS.</para>
+ </listitem>
+ </orderedlist>
+ </section>
+ <section id="Thumbnails">
+ <title>Thumbnails</title>
+ <para>Thumbnails can be displayed beside each image in the result list by enabling the Thumbnails check box.</para>
+ </section>
+ <section id="Orientation">
+ <title>Ignore Orientation</title>
+ <para>When selected and a similarity compare is being used, the images are checked against 4 rotations: 0°, 90°, 180°, 270°, plus flip and mirror.</para>
+ </section>
+ <section id="Sort">
+ <title>Sort</title>
+ <para>
+ The normal sort order is for groups (in the case of Similarity checks) with the highest number of near-100% matches to be at the top of the list.
+ <para />
+ If this box is checked, groups with the lowest number of matches are placed at the top of the list.
+ </para>
+ </section>
+ <section id="Comparetwofilesets">
+ <title>Compare two file sets</title>
+ <para>Sometimes it is useful to compare one group of files to another, different group of files. Enable this check box to compare two groups of files. When enabled, a second list will appear and files can be added to this list using the same methods for the main list.</para>
+ <para>When comparing two file sets the results list will display matches between the two lists. For each match group, the first file is always from the main group, and the remaining files are always from the second group.</para>
+ </section>
+ <section id="DragandDrop">
+ <title>Drag and Drop</title>
+ <para>Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</para>
+ </section>
+ <section id="ImageDataWindow">
+ <title>Image Data Window</title>
+ <para>
+ <code>Ctrl+Shift+Right Mouse click</code>
+ : Use this to display a dialog containing the data stored for the clicked image file. This is usually only useful for debugging purposes.
+ </para>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideImageSearchSearch">\r
- <title id="titleGuideImageSearchSearch">Search Window</title>\r
- <para>Geeqie provides a utility to find one or more images based on various parameters.</para>\r
- <para>\r
- To display a new Search Window press\r
- <keycap>F3</keycap>\r
- or select\r
- <guimenu>Search</guimenu>\r
- from the File menu.\r
- </para>\r
- <para>\r
- To start a search activate the\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="edit-find.png" />\r
- </guiicon>\r
- Find\r
- </guibutton>\r
- </code>\r
- button or press\r
- <code>Ctrl + Enter</code>\r
- . A search in progress can be stopped by activating the\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="process-stop.png" />\r
- </guiicon>\r
- Stop\r
- </guibutton>\r
- </code>\r
- button or press\r
- <code>Ctrl + Enter</code>\r
- .\r
- </para>\r
- <para>The progress of an active search is displayed as a progress bar at the bottom of the window. The progress bar will also display the total files that match the search parameters, and the total number of files searched.</para>\r
- <para>When a search is completed, the total number of files found and their total size will be displayed in the status bar.</para>\r
- <para />\r
- <section id="Searchlocation">\r
- <title>Search location</title>\r
- <para>One of several locations can be chosen as the source to use in the search.</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Path</guilabel>\r
- </term>\r
- <listitem>The search will include files located in the selected folder, enable the Recurse check box to include the contents of all sub folders.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Comments</guilabel>\r
- </term>\r
- <listitem>\r
- This option is only for use with GqView legacy metadata.\r
- <para />\r
- The search will include all files that have a keyword or comment associated to it.\r
- <note>Only keyword and comment associations stored in the user's home folder are included in this search type.</note>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Results</guilabel>\r
- </term>\r
- <listitem>The search will include all files currently listed in the results list. Use this to refine a previous search.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Collection</guilabel>\r
- </term>\r
- <listitem>The search will include all files in the selected collection.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- <para />\r
- </section>\r
- <section id="Searchparameters">\r
- <title>Search parameters</title>\r
- <para>Each search parameter can be enabled or disabled with the check box to its left. For a file to be a match, all enabled parameters must be true.</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>File</guilabel>\r
- </term>\r
- <listitem>\r
- If "name is" is selected, the search will match if the text exactly matches the file name. If "name contains" or "path contains" is selected, the search will match if the entered text appears within the file name or path.<para/>The text comparison can be made to be case sensitive by enabling the Match case checkbox.\r
- <para />\r
- If "contains" or "path contains" is selected,\r
- <link linkend="GuideReferencePCRE">Perl Compatible Regular Expressions</link>\r
- are used.\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>File size</guilabel>\r
- </term>\r
- <listitem>\r
- The search will match if the file size on disk is equal to, less than, greater than, or between the entered value, depending on the method selected from the drop down menu. The\r
- <emphasis>between</emphasis>\r
- test is inclusive - for example a file of size 10 will match if the size parameters are between 10 and 15.\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>File date</guilabel>\r
- </term>\r
- <listitem>\r
- The search will match if the file date is equal to, before, after, or between the entered date, depending on the method selected from the drop down menu. The\r
- <emphasis>between</emphasis>\r
- test is inclusive, for example a file with date of 10/04/2003 will match if the date parameters are between 10/04/2003 and 12/31/2003.\r
- <para />\r
- For convenience, the\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="go-down.png" />\r
- </guiicon>\r
- </guibutton>\r
- </code>\r
- button displays a pop up calendar to enter the date.\r
- <para />\r
- One of four date types may be selected. They are described in the\r
- <link linkend="GuideReferenceFileDates">Reference section</link>\r
- .\r
- <note>If an image does not have an exif date, it will default to 01 January 1970.</note>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Image dimensions</guilabel>\r
- </term>\r
- <listitem>\r
- The search will match if the image dimensions are equal to, less than, greater than, or between the entered values, depending on the method selected from the drop down menu. The\r
- <emphasis>between</emphasis>\r
- test is inclusive.\r
- <para />\r
- The image dimensions test is simple, both width and height must be within the allowed values for a match.\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Image content</guilabel>\r
- </term>\r
- <listitem>\r
- The search will match if the image contents are similar within the percentage value, inclusive. This uses the same test and data that is used to determine image similarity when\r
- <link linkend="GuideImageSearchFindingDuplicates">Finding Duplicates</link>\r
- . The entry is for entering the path for the image to use in this test.\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Keywords</guilabel>\r
- </term>\r
- <listitem>The search will match if the file's associated keywords match all, match any, or exclude the entered keywords, depending on the method selected from the drop down menu. Keywords can be separated with a space, comma, or tab character.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Comment</guilabel>\r
- </term>\r
- <listitem>\r
- The search will match if the file's Comments field contains the entered pattern.\r
- <link linkend="GuideReferencePCRE">Perl Compatible Regular Expressions</link>\r
- are used.\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Geocoded position</guilabel>\r
- </term>\r
- <listitem>\r
- The search will match if the file's GPS position is less than or greater than the selected distance from the specified position, or is not geocoded, depending on the method selected from the drop down menu.\r
- The search location can be specified by\r
- <itemizedlist>\r
- <listitem>\r
- Type in a latitude/longitude in the format\r
- <code>89.123 179.123</code>\r
- </listitem>\r
- <listitem>Drag-and-drop a geocoded image onto the search box</listitem>\r
- <listitem>If Geeqie's map is displayed, a left-click on the map will store the latitude/longitude under the mouse cursor into the clipboard. It can then be pasted into the search box.</listitem>\r
- <listitem>Copy-and-paste (in some circumstances drag-and-drop) the result of an Internet search.</listitem>\r
- </itemizedlist>\r
- <note>\r
- In this last case, the result of a search may contain the latitude/longitude embedded in the URL. This may be automatically decoded with the help of an external file:-\r
- <programlisting xml:space="preserve">$HOME/.config/geeqie/geocode-parameters.awk</programlisting>\r
- See\r
- <link linkend="GuideReferenceDecodeLatLong">Decoding Latitude and Longitude</link>\r
- for details on how to create this file.\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Class</guilabel>\r
- </term>\r
- <listitem>\r
- The search will match if the file's class is, or is not, one of the following types.\r
- <itemizedlist>\r
- <listitem>Unknown</listitem>\r
- <listitem>Image</listitem>\r
- <listitem>Raw Image</listitem>\r
- <listitem>Video</listitem>\r
- <listitem>Document</listitem>\r
- <listitem>Metadata</listitem>\r
- <listitem>Unknown</listitem>\r
- <listitem>Broken (Of class Image, Raw Image, Video, or Document, but Geeqie cannot display an image)</listitem>\r
- </itemizedlist>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Marks</guilabel>\r
- </term>\r
- <listitem>\r
- The search will match if the file does or does not have a mark attached to it. Refer to\r
- <link linkend="GuideImageMarks">Marking Images</link>\r
- .\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- <para />\r
- </section>\r
- <section id="Resultslist">\r
- <title>Results list</title>\r
- <para>Files that match the parameters of the search are shown in the list. By default they are displayed in the order that they are found. To sort the results list by a column, activate or click the column title. Activating a column that is already used to sort the list will toggle between increasing and decreasing sort order.</para>\r
- <para>\r
- A\r
- <emphasis role="strong">context menu</emphasis>\r
- is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus.\r
- </para>\r
- <para>\r
- The\r
- <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />\r
- available are listed here.\r
- </para>\r
- <para>The image Dimensions column of the result list will only contain dimension information when dimensions are included in the search parameters.</para>\r
- <para />\r
- </section>\r
- <section id="Statusbar">\r
- <title>Status bar</title>\r
- <para>At the bottom of the search window is an area that includes the following items from left to right:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Thumbnails</guilabel>\r
- </term>\r
- <listitem>Enable this check box to display a thumbnail next to each image in the results list.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>File count display</guilabel>\r
- </term>\r
- <listitem>Displays the total count of files in the results list, and their size on disk. The count of selected files will appear in parenthesis.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Search progress</guilabel>\r
- </term>\r
- <listitem>When a search is active, the text “Searching...” will appear here. Two numbers in parenthesis will also be displayed, the first number is the number of files that match the search parameters and the second number is the total number of files that were searched.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="edit-find.png" />\r
- </guiicon>\r
- Find\r
- </guibutton>\r
- </code>\r
- </term>\r
- <listitem>Activate the find button to start a search with the selected parameters.</listitem>\r
- </varlistentry>\r
- <para />\r
- <varlistentry>\r
- <term>\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="process-stop.png" />\r
- </guiicon>\r
- Stop\r
- </guibutton>\r
- </code>\r
- </term>\r
- <listitem>Activate the stop button to end a search that is in progress.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- <para />\r
- </section>\r
- <section id="DragandDrop">\r
- <title>Drag and Drop</title>\r
- <para>Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</para>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImageSearchSearch">
+ <title id="titleGuideImageSearchSearch">Search Window</title>
+ <para>Geeqie provides a utility to find one or more images based on various parameters.</para>
+ <para>
+ To display a new Search Window press
+ <keycap>F3</keycap>
+ or select
+ <guimenu>Search</guimenu>
+ from the File menu.
+ </para>
+ <para>
+ To start a search activate the
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="edit-find.png" />
+ </guiicon>
+ Find
+ </guibutton>
+ </code>
+ button or press
+ <code>Ctrl + Enter</code>
+ . A search in progress can be stopped by activating the
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="process-stop.png" />
+ </guiicon>
+ Stop
+ </guibutton>
+ </code>
+ button or press
+ <code>Ctrl + Enter</code>
+ .
+ </para>
+ <para>The progress of an active search is displayed as a progress bar at the bottom of the window. The progress bar will also display the total files that match the search parameters, and the total number of files searched.</para>
+ <para>When a search is completed, the total number of files found and their total size will be displayed in the status bar.</para>
+ <para />
+ <section id="Searchlocation">
+ <title>Search location</title>
+ <para>One of several locations can be chosen as the source to use in the search.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Path</guilabel>
+ </term>
+ <listitem>The search will include files located in the selected folder, enable the Recurse check box to include the contents of all sub folders.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Comments</guilabel>
+ </term>
+ <listitem>
+ This option is only for use with GqView legacy metadata.
+ <para />
+ The search will include all files that have a keyword or comment associated to it.
+ <note>Only keyword and comment associations stored in the user's home folder are included in this search type.</note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Results</guilabel>
+ </term>
+ <listitem>The search will include all files currently listed in the results list. Use this to refine a previous search.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Collection</guilabel>
+ </term>
+ <listitem>The search will include all files in the selected collection.</listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ <para />
+ </section>
+ <section id="Searchparameters">
+ <title>Search parameters</title>
+ <para>Each search parameter can be enabled or disabled with the check box to its left. For a file to be a match, all enabled parameters must be true.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>File</guilabel>
+ </term>
+ <listitem>
+ If "name is" is selected, the search will match if the text exactly matches the file name. If "name contains" or "path contains" is selected, the search will match if the entered text appears within the file name or path.<para/>The text comparison can be made to be case sensitive by enabling the Match case checkbox.
+ <para />
+ If "contains" or "path contains" is selected,
+ <link linkend="GuideReferencePCRE">Perl Compatible Regular Expressions</link>
+ are used.
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>File size</guilabel>
+ </term>
+ <listitem>
+ The search will match if the file size on disk is equal to, less than, greater than, or between the entered value, depending on the method selected from the drop down menu. The
+ <emphasis>between</emphasis>
+ test is inclusive - for example a file of size 10 will match if the size parameters are between 10 and 15.
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>File date</guilabel>
+ </term>
+ <listitem>
+ The search will match if the file date is equal to, before, after, or between the entered date, depending on the method selected from the drop down menu. The
+ <emphasis>between</emphasis>
+ test is inclusive, for example a file with date of 10/04/2003 will match if the date parameters are between 10/04/2003 and 12/31/2003.
+ <para />
+ For convenience, the
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="go-down.png" />
+ </guiicon>
+ </guibutton>
+ </code>
+ button displays a pop up calendar to enter the date.
+ <para />
+ One of four date types may be selected. They are described in the
+ <link linkend="GuideReferenceFileDates">Reference section</link>
+ .
+ <note>If an image does not have an exif date, it will default to 01 January 1970.</note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Image dimensions</guilabel>
+ </term>
+ <listitem>
+ The search will match if the image dimensions are equal to, less than, greater than, or between the entered values, depending on the method selected from the drop down menu. The
+ <emphasis>between</emphasis>
+ test is inclusive.
+ <para />
+ The image dimensions test is simple, both width and height must be within the allowed values for a match.
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Image content</guilabel>
+ </term>
+ <listitem>
+ The search will match if the image contents are similar within the percentage value, inclusive. This uses the same test and data that is used to determine image similarity when
+ <link linkend="GuideImageSearchFindingDuplicates">Finding Duplicates</link>
+ . The entry is for entering the path for the image to use in this test.
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Keywords</guilabel>
+ </term>
+ <listitem>The search will match if the file's associated keywords match all, match any, or exclude the entered keywords, depending on the method selected from the drop down menu. Keywords can be separated with a space, comma, or tab character.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Comment</guilabel>
+ </term>
+ <listitem>
+ The search will match if the file's Comments field contains the entered pattern.
+ <link linkend="GuideReferencePCRE">Perl Compatible Regular Expressions</link>
+ are used.
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Geocoded position</guilabel>
+ </term>
+ <listitem>
+ The search will match if the file's GPS position is less than or greater than the selected distance from the specified position, or is not geocoded, depending on the method selected from the drop down menu.
+ The search location can be specified by
+ <itemizedlist>
+ <listitem>
+ Type in a latitude/longitude in the format
+ <code>89.123 179.123</code>
+ </listitem>
+ <listitem>Drag-and-drop a geocoded image onto the search box</listitem>
+ <listitem>If Geeqie's map is displayed, a left-click on the map will store the latitude/longitude under the mouse cursor into the clipboard. It can then be pasted into the search box.</listitem>
+ <listitem>Copy-and-paste (in some circumstances drag-and-drop) the result of an Internet search.</listitem>
+ </itemizedlist>
+ <note>
+ In this last case, the result of a search may contain the latitude/longitude embedded in the URL. This may be automatically decoded with the help of an external file:-
+ <programlisting xml:space="preserve">$HOME/.config/geeqie/geocode-parameters.awk</programlisting>
+ See
+ <link linkend="GuideReferenceDecodeLatLong">Decoding Latitude and Longitude</link>
+ for details on how to create this file.
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Class</guilabel>
+ </term>
+ <listitem>
+ The search will match if the file's class is, or is not, one of the following types.
+ <itemizedlist>
+ <listitem>Unknown</listitem>
+ <listitem>Image</listitem>
+ <listitem>Raw Image</listitem>
+ <listitem>Video</listitem>
+ <listitem>Document</listitem>
+ <listitem>Metadata</listitem>
+ <listitem>Unknown</listitem>
+ <listitem>Broken (Of class Image, Raw Image, Video, or Document, but Geeqie cannot display an image)</listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Marks</guilabel>
+ </term>
+ <listitem>
+ The search will match if the file does or does not have a mark attached to it. Refer to
+ <link linkend="GuideImageMarks">Marking Images</link>
+ .
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ <para />
+ </section>
+ <section id="Resultslist">
+ <title>Results list</title>
+ <para>Files that match the parameters of the search are shown in the list. By default they are displayed in the order that they are found. To sort the results list by a column, activate or click the column title. Activating a column that is already used to sort the list will toggle between increasing and decreasing sort order.</para>
+ <para>
+ A
+ <emphasis role="strong">context menu</emphasis>
+ is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus.
+ </para>
+ <para>
+ The
+ <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />
+ available are listed here.
+ </para>
+ <para>The image Dimensions column of the result list will only contain dimension information when dimensions are included in the search parameters.</para>
+ <para />
+ </section>
+ <section id="Statusbar">
+ <title>Status bar</title>
+ <para>At the bottom of the search window is an area that includes the following items from left to right:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Thumbnails</guilabel>
+ </term>
+ <listitem>Enable this check box to display a thumbnail next to each image in the results list.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>File count display</guilabel>
+ </term>
+ <listitem>Displays the total count of files in the results list, and their size on disk. The count of selected files will appear in parenthesis.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Search progress</guilabel>
+ </term>
+ <listitem>When a search is active, the text “Searching...” will appear here. Two numbers in parenthesis will also be displayed, the first number is the number of files that match the search parameters and the second number is the total number of files that were searched.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="edit-find.png" />
+ </guiicon>
+ Find
+ </guibutton>
+ </code>
+ </term>
+ <listitem>Activate the find button to start a search with the selected parameters.</listitem>
+ </varlistentry>
+ <para />
+ <varlistentry>
+ <term>
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="process-stop.png" />
+ </guiicon>
+ Stop
+ </guibutton>
+ </code>
+ </term>
+ <listitem>Activate the stop button to end a search that is in progress.</listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ <para />
+ </section>
+ <section id="DragandDrop">
+ <title>Drag and Drop</title>
+ <para>Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</para>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<!DOCTYPE html>\r
-<book id="GuideIndex">\r
- <title>The Geeqie User Manual</title>\r
- <bookinfo>\r
- <abstract role="description">\r
- <para>This is a description of the document.</para>\r
- </abstract>\r
- <copyright>\r
- <year>2004</year>\r
- <holder>John Ellis</holder>\r
- </copyright>\r
- <copyright>\r
- <year>2008-2016</year>\r
- <holder>The Geeqie Team</holder>\r
- </copyright>\r
- <publisher role="maintainer">\r
- <publishername>The Geeqie Team</publishername>\r
- </publisher>\r
- <author>\r
- <firstname>John</firstname>\r
- <surname>Ellis</surname>\r
- <affiliation>\r
- <orgname>Geeqie Project</orgname>\r
- </affiliation>\r
- <email>geeqie@freelists.org</email>\r
- </author>\r
- <revhistory>\r
- <revision>\r
- <revnumber>0.1</revnumber>\r
- <date>2004-01-01</date>\r
- <revdescription>\r
- <para role="author">John Ellis</para>\r
- <para role="publisher">Gqview Project</para>\r
- </revdescription>\r
- </revision>\r
- <revision>\r
- <revnumber>0.2</revnumber>\r
- <date>2016-05-30</date>\r
- <revdescription>\r
- <para role="author">Colin Clark</para>\r
- <para role="publisher">The Geeqie Team</para>\r
- </revdescription>\r
- </revision>\r
- </revhistory>\r
- <legalnotice>\r
- <title>Feedback</title>\r
- <para>\r
- Comments and general help:\r
- <email>geeqie@freelists.org</email>\r
- </para>\r
- <para>\r
- Bugs and Feature Requests:\r
- <ulink url="https://github.com/BestImageViewer/geeqie/issues">Geeqie Issues</ulink>\r
- </para>\r
- <para>\r
- Website:\r
- <ulink url="http://geeqie.org">geeqie.org</ulink>\r
- </para>\r
- </legalnotice>\r
- </bookinfo>\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideIntroduction.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindow.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideSidebars.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherWindows.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearch.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagementPlugins.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagement.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideColorManagement.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImagePresentation.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuidePrinting.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsMain.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsAdditional.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReference.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherSoftware.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideFaq.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideLicence.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideCredits.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideGnuFdl.xml" />\r
- <para />\r
-</book>\r
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html>
+<book id="GuideIndex">
+ <title>The Geeqie User Manual</title>
+ <bookinfo>
+ <abstract role="description">
+ <para>This is a description of the document.</para>
+ </abstract>
+ <copyright>
+ <year>2004</year>
+ <holder>John Ellis</holder>
+ </copyright>
+ <copyright>
+ <year>2008-2016</year>
+ <holder>The Geeqie Team</holder>
+ </copyright>
+ <publisher role="maintainer">
+ <publishername>The Geeqie Team</publishername>
+ </publisher>
+ <author>
+ <firstname>John</firstname>
+ <surname>Ellis</surname>
+ <affiliation>
+ <orgname>Geeqie Project</orgname>
+ </affiliation>
+ <email>geeqie@freelists.org</email>
+ </author>
+ <revhistory>
+ <revision>
+ <revnumber>0.1</revnumber>
+ <date>2004-01-01</date>
+ <revdescription>
+ <para role="author">John Ellis</para>
+ <para role="publisher">Gqview Project</para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>0.2</revnumber>
+ <date>2016-05-30</date>
+ <revdescription>
+ <para role="author">Colin Clark</para>
+ <para role="publisher">The Geeqie Team</para>
+ </revdescription>
+ </revision>
+ </revhistory>
+ <legalnotice>
+ <title>Feedback</title>
+ <para>
+ Comments and general help:
+ <email>geeqie@freelists.org</email>
+ </para>
+ <para>
+ Bugs and Feature Requests:
+ <ulink url="https://github.com/BestImageViewer/geeqie/issues">Geeqie Issues</ulink>
+ </para>
+ <para>
+ Website:
+ <ulink url="http://geeqie.org">geeqie.org</ulink>
+ </para>
+ </legalnotice>
+ </bookinfo>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideIntroduction.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindow.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideSidebars.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherWindows.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageSearch.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagementPlugins.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImageManagement.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideColorManagement.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideImagePresentation.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuidePrinting.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsMain.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsAdditional.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReference.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherSoftware.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideFaq.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideLicence.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideCredits.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideGnuFdl.xml" />
+ <para />
+</book>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideIntroduction">\r
- <title>Introduction</title>\r
- <para>Geeqie is an image viewer that makes navigation of images easy. Images can be viewed as thumbnails, in multiple windows or in full screen mode.</para>\r
- <para>Geeqie is an image manager, with complete copy, move, rename, and delete functions available at the press of a button.</para>\r
- <para>Extensive image collections can be easily handled using a combination of Geeqie's flexible Keyword facility and powerful Image searches.</para>\r
- <para>Image collections can be refined with a duplicate image finder.</para>\r
- <para>Geeqie is ideal for making presentations. A slide-show feature is built in, and Geeqie can be remotely controlled either via command line scripts or an infra-red device. Information such as f-stop, shutter speed and descriptive text can be overlaid onto the image display.</para>\r
- <para>There is no need to import images into Geeqie - simply point Geeqie to a folder containing images, and your data will be displayed.</para>\r
- <para>Geeqie is an image viewer, not an image editor. However, Geeqie can be configured to call external image editors such as the Gimp, resulting in a very powerful combination.</para>\r
- <para />\r
- <section id="Features">\r
- <title>Features</title>\r
- <section id="BasicFeatures">\r
- <title>Basic Features</title>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <link linkend="Iconview" endterm="titleIconview" />\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideImagePresentationFullscreen" endterm="titleGuideImagePresentationFullscreen" />\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideImagePresentationSlideshow" endterm="titleGuideImagePresentationSlideshow" />\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideImageManagement" endterm="titleGuideImageManagement" />\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideCollections" endterm="titleGuideCollections" />\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="AdvancedFeatures">\r
- <title>Advanced Features</title>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <link linkend="GuideImageSearch" endterm="titleGuideImageSearch" />\r
- <para>Image Search based on many parameters</para>\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideImageSearchFindingDuplicates" endterm="titleGuideImageSearchFindingDuplicates" />\r
- <para>Find image duplicates based on image content</para>\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideSidebarsInfo" endterm="titleExif" />\r
- <para>View IPTC, and view and edit Exif and XMP data stored in images</para>\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideSidebarsSortManager" endterm="titleGuideSidebarsSortManager" />\r
- <para>Simple Sort Manager to quickly sort a folder of images into other folders</para>\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideImageManagementRename" endterm="titleGuideImageManagementRename" />\r
- <para>Rename images in bulk</para>\r
- </listitem>\r
- <listitem>\r
- <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />\r
- <para>Overlay the image with a panel showing user-definable data</para>\r
- </listitem>\r
- <listitem>\r
- <link linkend="Keywords" endterm="titleKeywords" />\r
- <para>Add XMP keywords to images, and recall those images with the search function</para>\r
- </listitem>\r
- <listitem>\r
- <link linkend="GuideOptions" endterm="titleGuideOptions" />\r
- <para>Geeqie is a very configurable application</para>\r
- </listitem>\r
- </itemizedlist>\r
- <para>“An application that displays images.” - This was, and still is, the primary goal of Geeqie. Over time image management features have been added, but the core purpose of Geeqie remains the same.</para>\r
- <para />\r
- </section>\r
- </section>\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideIntroduction">
+ <title>Introduction</title>
+ <para>Geeqie is an image viewer that makes navigation of images easy. Images can be viewed as thumbnails, in multiple windows or in full screen mode.</para>
+ <para>Geeqie is an image manager, with complete copy, move, rename, and delete functions available at the press of a button.</para>
+ <para>Extensive image collections can be easily handled using a combination of Geeqie's flexible Keyword facility and powerful Image searches.</para>
+ <para>Image collections can be refined with a duplicate image finder.</para>
+ <para>Geeqie is ideal for making presentations. A slide-show feature is built in, and Geeqie can be remotely controlled either via command line scripts or an infra-red device. Information such as f-stop, shutter speed and descriptive text can be overlaid onto the image display.</para>
+ <para>There is no need to import images into Geeqie - simply point Geeqie to a folder containing images, and your data will be displayed.</para>
+ <para>Geeqie is an image viewer, not an image editor. However, Geeqie can be configured to call external image editors such as the Gimp, resulting in a very powerful combination.</para>
+ <para />
+ <section id="Features">
+ <title>Features</title>
+ <section id="BasicFeatures">
+ <title>Basic Features</title>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <link linkend="Iconview" endterm="titleIconview" />
+ </listitem>
+ <listitem>
+ <link linkend="GuideImagePresentationFullscreen" endterm="titleGuideImagePresentationFullscreen" />
+ </listitem>
+ <listitem>
+ <link linkend="GuideImagePresentationSlideshow" endterm="titleGuideImagePresentationSlideshow" />
+ </listitem>
+ <listitem>
+ <link linkend="GuideImageManagement" endterm="titleGuideImageManagement" />
+ </listitem>
+ <listitem>
+ <link linkend="GuideCollections" endterm="titleGuideCollections" />
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="AdvancedFeatures">
+ <title>Advanced Features</title>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <link linkend="GuideImageSearch" endterm="titleGuideImageSearch" />
+ <para>Image Search based on many parameters</para>
+ </listitem>
+ <listitem>
+ <link linkend="GuideImageSearchFindingDuplicates" endterm="titleGuideImageSearchFindingDuplicates" />
+ <para>Find image duplicates based on image content</para>
+ </listitem>
+ <listitem>
+ <link linkend="GuideSidebarsInfo" endterm="titleExif" />
+ <para>View IPTC, and view and edit Exif and XMP data stored in images</para>
+ </listitem>
+ <listitem>
+ <link linkend="GuideSidebarsSortManager" endterm="titleGuideSidebarsSortManager" />
+ <para>Simple Sort Manager to quickly sort a folder of images into other folders</para>
+ </listitem>
+ <listitem>
+ <link linkend="GuideImageManagementRename" endterm="titleGuideImageManagementRename" />
+ <para>Rename images in bulk</para>
+ </listitem>
+ <listitem>
+ <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />
+ <para>Overlay the image with a panel showing user-definable data</para>
+ </listitem>
+ <listitem>
+ <link linkend="Keywords" endterm="titleKeywords" />
+ <para>Add XMP keywords to images, and recall those images with the search function</para>
+ </listitem>
+ <listitem>
+ <link linkend="GuideOptions" endterm="titleGuideOptions" />
+ <para>Geeqie is a very configurable application</para>
+ </listitem>
+ </itemizedlist>
+ <para>“An application that displays images.” - This was, and still is, the primary goal of Geeqie. Over time image management features have been added, but the core purpose of Geeqie remains the same.</para>
+ <para />
+ </section>
+ </section>
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideMainWindow">\r
- <title>Main Window</title>\r
- <para>\r
- The Geeqie main window is designed for quick and easy navigation of images. The window consists of three regions: the\r
- <link linkend="GuideMainWindowFilePane" endterm="titleGuideMainWindowFilePane" />\r
- , the\r
- <link linkend="GuideMainWindowFolderPane" endterm="titleGuideMainWindowFolderPane" />\r
- , and the\r
- <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />\r
- (optionally bordered by\r
- <link linkend="GuideSidebars" endterm="titleGuideSidebars" />\r
- )\r
- , all bordered by\r
- <link linkend="GuideMainWindowMenus" endterm="titleGuideMainWindowMenus" />\r
- and\r
- <link linkend="GuideMainWindowStatusBar" endterm="titleGuideMainWindowStatusBar" />\r
- .\r
- </para>\r
- <para>\r
- Multiple instances of the main window may be started via the\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>N</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Windows</guimenu>\r
- <guimenuitem>New Window</guimenuitem>\r
- </menuchoice>\r
- menu item, and the\r
- <link linkend="GuideMainWindowLayout" endterm="titleGuideMainWindowLayout" />\r
- of each may be individually configured in the\r
- <link linkend="GuideOptionsLayout" endterm="titleGuideOptionsLayout" />\r
- dialogue.\r
- </para>\r
- <para>\r
- If several instances of the main window are open, they may be closed individually or simultaneously. If\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>Q</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Quit</guimenuitem>\r
- </menuchoice>\r
- is pressed, all windows will be closed. When Geeqie is re-opened the same windows will be re-displayed.\r
- <para />\r
- If\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>W</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Windows</guimenu>\r
- <guimenuitem>Close Window</guimenuitem>\r
- </menuchoice>\r
- is pressed, only that window will be closed unless that window is the "main" window, in which case all windows will be closed. When Geeqie is restarted only the main window will be displayed.\r
- <para />\r
- The main window may be recognised by the word "Geeqie" in the title bar, as opposed to other windows which have the word "geeqie".\r
- <para />\r
- Several window layouts may be defined and displayed at any time, as described in the\r
- <link linkend="Windowmenu">Windows menu</link>\r
- .\r
- </para>\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowFilePane.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowFolderPane.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowImagePane.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowNavigation.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowMenus.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowStatusBar.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowLayout.xml" />\r
- <para />\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideMainWindow">
+ <title>Main Window</title>
+ <para>
+ The Geeqie main window is designed for quick and easy navigation of images. The window consists of three regions: the
+ <link linkend="GuideMainWindowFilePane" endterm="titleGuideMainWindowFilePane" />
+ , the
+ <link linkend="GuideMainWindowFolderPane" endterm="titleGuideMainWindowFolderPane" />
+ , and the
+ <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />
+ (optionally bordered by
+ <link linkend="GuideSidebars" endterm="titleGuideSidebars" />
+ )
+ , all bordered by
+ <link linkend="GuideMainWindowMenus" endterm="titleGuideMainWindowMenus" />
+ and
+ <link linkend="GuideMainWindowStatusBar" endterm="titleGuideMainWindowStatusBar" />
+ .
+ </para>
+ <para>
+ Multiple instances of the main window may be started via the
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>N</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Windows</guimenu>
+ <guimenuitem>New Window</guimenuitem>
+ </menuchoice>
+ menu item, and the
+ <link linkend="GuideMainWindowLayout" endterm="titleGuideMainWindowLayout" />
+ of each may be individually configured in the
+ <link linkend="GuideOptionsLayout" endterm="titleGuideOptionsLayout" />
+ dialogue.
+ </para>
+ <para>
+ If several instances of the main window are open, they may be closed individually or simultaneously. If
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>Q</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Quit</guimenuitem>
+ </menuchoice>
+ is pressed, all windows will be closed. When Geeqie is re-opened the same windows will be re-displayed.
+ <para />
+ If
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>W</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Windows</guimenu>
+ <guimenuitem>Close Window</guimenuitem>
+ </menuchoice>
+ is pressed, only that window will be closed unless that window is the "main" window, in which case all windows will be closed. When Geeqie is restarted only the main window will be displayed.
+ <para />
+ The main window may be recognised by the word "Geeqie" in the title bar, as opposed to other windows which have the word "geeqie".
+ <para />
+ Several window layouts may be defined and displayed at any time, as described in the
+ <link linkend="Windowmenu">Windows menu</link>
+ .
+ </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowFilePane.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowFolderPane.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowImagePane.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowNavigation.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowMenus.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowStatusBar.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideMainWindowLayout.xml" />
+ <para />
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideMainWindowFilePane">\r
- <title id="titleGuideMainWindowFilePane">File Pane</title>\r
- <para>The file pane displays the images contained in the active folder. It has two modes of display, allows multiple selection, and can initiate drag and drop operations.</para>\r
- <para>\r
- A\r
- <emphasis role="strong">context menu</emphasis>\r
- can be displayed by clicking the right mouse button on the file pane or pressing the menu key while the file pane has the focus.\r
- </para>\r
- <para />\r
- <section id="Listview">\r
- <title>List view</title>\r
- <para>\r
- This mode can be enabled by selecting\r
- <emphasis role="bold">List</emphasis>\r
- from the\r
- <emphasis role="bold">View</emphasis>\r
- menu, pressing <code>Ctrl + L</code>, or unselecting\r
- <emphasis role="bold">View as icons</emphasis>\r
- from the context menu.\r
- </para>\r
- <para>The list view mode displays images in a standard vertical list. Three columns provide the file name, size in bytes, and the time the contents were last modified.</para>\r
- <para>\r
- Thumbnails can be displayed next to each file in the list, to toggle thumbnails on or off by selecting\r
- <emphasis role="bold">Thumbnails</emphasis>\r
- from the\r
- <emphasis role="bold">View</emphasis>\r
- menu, pressing <code>T</code>, clicking <imagedata fileref="icon_thumb.png"></imagedata> on the tool bar, or selecting\r
- <emphasis role="bold">Show thumbnails</emphasis>\r
- from the context menu.\r
- </para>\r
- <para>\r
- <link linkend="GuideOptionsFiltering">Grouped sidecar files</link>\r
- are represented by the main file with an expander. Clicking on the expander shows sidecar files.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Iconview">\r
- <title id="titleIconview">Icon view</title>\r
- <para>\r
- This mode can be enabled by selecting\r
- <emphasis role="bold">Icons</emphasis>\r
- from the View menu, pressing <code>Ctrl + I</code>, or selecting\r
- <emphasis role="bold">View as icons</emphasis>\r
- from the context menu.\r
- </para>\r
- <para>The icon view mode displays images as thumbnails in a grid, and by default a file name below each thumbnail.</para>\r
- <para>\r
- The \r
- file name displayed below each thumbnail can be turned on or off by selecting\r
- <emphasis role="bold">Show filename text</emphasis>\r
- from the context menu.\r
- </para>\r
- <para>\r
- <link linkend="GuideOptionsFiltering">Grouped sidecar files</link>\r
- are represented by the main file. For accessing sidecars switch to List mode.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Filefilter">\r
- <title id="titleFilefilter">File Filter</title>\r
- <para>\r
- A filter box can be opened by selecting\r
- <emphasis role="bold">Show File Filter</emphasis>\r
- from the View menu.\r
- </para>\r
- <para>\r
- Characters you type into this box will be used for pattern matching to select the files displayed.\r
- <link linkend="GuideReferencePCRE">Regular expressions</link>\r
- are used in this field.\r
- <para />\r
- For basic pattern matching "JPG" will match any filename containing those characters.\r
- <para />\r
- If you type a newline, the text will be saved in the dropdown box list. The last 10 items are saved.\r
- <para />\r
- To delete an item, select it from the drop-down list, click on the text box to select the text, and then press\r
- <keycap>Delete</keycap>\r
- followed by\r
- <keycap>Enter</keycap>\r
- .\r
- </para>\r
- <para>By default filtering is case-insensitive. A checkbox labelled "Case" permits the filter to be made case-sensitive.\r
- </para>\r
- <para>Additionally a drop-down box permits any of the file <link linkend="Filetypes">Classes</link> to be selected or deselected from the viewed list.</para>\r
- <para />\r
- </section>\r
- <section id="Multipleselection">\r
- <title>Multiple selection</title>\r
- <para>It is possible to select more than one image from the file pane. Multiple files can be selected with several methods:</para>\r
- <para />\r
- <section id="Mouse">\r
- <title>Mouse</title>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para><code>Ctrl</code> + Primary mouse button will add or remove the file from the selection.</para>\r
- </listitem>\r
- <listitem>\r
- <para>Middle mouse button will toggle selection of the file.</para>\r
- </listitem>\r
- <listitem>\r
- <para><code>Shift</code> + Primary mouse button will select all images between the clicked and focused image, or it will unselect all those images if the clicked image is already selected.</para>\r
- </listitem>\r
- <listitem>\r
- <para><code>Shift + Ctrl</code> + Primary mouse button works as Shift + Primary mouse button, but will not change the selection of files outside the region between the focus and clicked image.</para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="Keyboard">\r
- <title>Keyboard</title>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para><code>Ctrl + Arrows</code> will move the focus without changing the selection.</para>\r
- </listitem>\r
- <listitem>\r
- <para><code>Ctrl + Space</code> will toggle selection of the focused image.</para>\r
- </listitem>\r
- <listitem>\r
- <para><code>Shift + Arrows</code> will select a region of images.</para>\r
- </listitem>\r
- <listitem>\r
- <para><code>Shift + Ctrl + Arrows</code> works as <code>Shift + Arrows</code>, but will not change the selection of files outside the current focus region.</para>\r
- </listitem>\r
- </itemizedlist>\r
- <para>\r
- To select all files press <code>Ctrl + A</code>, or to unselect all image press <code>Ctrl + Shift + A</code>. These operations are also available from the\r
- <emphasis role="bold">Edit</emphasis>\r
- menu as\r
- <emphasis role="bold">Select all</emphasis>\r
- and\r
- <emphasis role="bold">Select none</emphasis>\r
- .\r
- </para>\r
- <para>\r
- The current number of selected images and their total size will be indicated in the File list section of the\r
- <link linkend="GuideMainWindowStatusBar">status bar</link>\r
- .\r
- </para>\r
- <para />\r
- </section>\r
- </section>\r
- <section id="Sorting">\r
- <title>Sorting</title>\r
- <para>The order of the images can be changed by clicking the sort area of the status bar or from the context menu. The sort methods are by file name, number, file date, or file size. The number method will sort file names by their natural order, for example files with names of file_10, file_12, and file_9 will appear in order file_9, file_10, and file_12.</para>\r
- <para>Selecting the ascending menu item will toggle between increasing and decreasing sort order.</para>\r
- <para />\r
- </section>\r
- <section id="Contextmenu">\r
- <title>Context menu</title>\r
- <para>\r
- Right clicking the mouse or pressing the menu key while the file pane has focus will display a menu. The menu functions will perform the same as those that match the window's\r
- <link linkend="GuideMainWindowMenus">menu bar</link>\r
- , however a few functions are unique to the context menu:\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <emphasis role="bold">View in new window</emphasis>\r
- </term>\r
- <listitem>\r
- <para>Opens a new window containing a list of the currently selected images.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <emphasis role="bold">Sort</emphasis>\r
- </term>\r
- <listitem>\r
- <para>Changes the sort order of file pane.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <emphasis role="bold">View as icons</emphasis>\r
- </term>\r
- <listitem>\r
- <para>Toggles between the list and icon view modes.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <emphasis role="bold">Show thumbnails</emphasis>\r
- </term>\r
- <listitem>\r
- <para>Toggles display of thumbnails in the list view display mode.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <emphasis role="bold">Show filename text</emphasis>\r
- </term>\r
- <listitem>\r
- <para>Toggles display of file names in the icon view display mode.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <emphasis role="bold">Show star rating</emphasis>\r
- </term>\r
- <listitem>\r
- <para>Toggles display of the "star rating" (Xmp.xmp.Rating).</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="DragandDrop">\r
- <title>Drag and Drop</title>\r
- <para>Drag and drop can be initialized with the primary or middle mouse buttons in the file pane. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</para>\r
- <para />\r
- </section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideMainWindowFilePane">
+ <title id="titleGuideMainWindowFilePane">File Pane</title>
+ <para>The file pane displays the images contained in the active folder. It has two modes of display, allows multiple selection, and can initiate drag and drop operations.</para>
+ <para>
+ A
+ <emphasis role="strong">context menu</emphasis>
+ can be displayed by clicking the right mouse button on the file pane or pressing the menu key while the file pane has the focus.
+ </para>
+ <para />
+ <section id="Listview">
+ <title>List view</title>
+ <para>
+ This mode can be enabled by selecting
+ <emphasis role="bold">List</emphasis>
+ from the
+ <emphasis role="bold">View</emphasis>
+ menu, pressing <code>Ctrl + L</code>, or unselecting
+ <emphasis role="bold">View as icons</emphasis>
+ from the context menu.
+ </para>
+ <para>The list view mode displays images in a standard vertical list. Three columns provide the file name, size in bytes, and the time the contents were last modified.</para>
+ <para>
+ Thumbnails can be displayed next to each file in the list, to toggle thumbnails on or off by selecting
+ <emphasis role="bold">Thumbnails</emphasis>
+ from the
+ <emphasis role="bold">View</emphasis>
+ menu, pressing <code>T</code>, clicking <imagedata fileref="icon_thumb.png"></imagedata> on the tool bar, or selecting
+ <emphasis role="bold">Show thumbnails</emphasis>
+ from the context menu.
+ </para>
+ <para>
+ <link linkend="GuideOptionsFiltering">Grouped sidecar files</link>
+ are represented by the main file with an expander. Clicking on the expander shows sidecar files.
+ </para>
+ <para />
+ </section>
+ <section id="Iconview">
+ <title id="titleIconview">Icon view</title>
+ <para>
+ This mode can be enabled by selecting
+ <emphasis role="bold">Icons</emphasis>
+ from the View menu, pressing <code>Ctrl + I</code>, or selecting
+ <emphasis role="bold">View as icons</emphasis>
+ from the context menu.
+ </para>
+ <para>The icon view mode displays images as thumbnails in a grid, and by default a file name below each thumbnail.</para>
+ <para>
+ The
+ file name displayed below each thumbnail can be turned on or off by selecting
+ <emphasis role="bold">Show filename text</emphasis>
+ from the context menu.
+ </para>
+ <para>
+ <link linkend="GuideOptionsFiltering">Grouped sidecar files</link>
+ are represented by the main file. For accessing sidecars switch to List mode.
+ </para>
+ <para />
+ </section>
+ <section id="Filefilter">
+ <title id="titleFilefilter">File Filter</title>
+ <para>
+ A filter box can be opened by selecting
+ <emphasis role="bold">Show File Filter</emphasis>
+ from the View menu.
+ </para>
+ <para>
+ Characters you type into this box will be used for pattern matching to select the files displayed.
+ <link linkend="GuideReferencePCRE">Regular expressions</link>
+ are used in this field.
+ <para />
+ For basic pattern matching "JPG" will match any filename containing those characters.
+ <para />
+ If you type a newline, the text will be saved in the dropdown box list. The last 10 items are saved.
+ <para />
+ To delete an item, select it from the drop-down list, click on the text box to select the text, and then press
+ <keycap>Delete</keycap>
+ followed by
+ <keycap>Enter</keycap>
+ .
+ </para>
+ <para>By default filtering is case-insensitive. A checkbox labelled "Case" permits the filter to be made case-sensitive.
+ </para>
+ <para>Additionally a drop-down box permits any of the file <link linkend="Filetypes">Classes</link> to be selected or deselected from the viewed list.</para>
+ <para />
+ </section>
+ <section id="Multipleselection">
+ <title>Multiple selection</title>
+ <para>It is possible to select more than one image from the file pane. Multiple files can be selected with several methods:</para>
+ <para />
+ <section id="Mouse">
+ <title>Mouse</title>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para><code>Ctrl</code> + Primary mouse button will add or remove the file from the selection.</para>
+ </listitem>
+ <listitem>
+ <para>Middle mouse button will toggle selection of the file.</para>
+ </listitem>
+ <listitem>
+ <para><code>Shift</code> + Primary mouse button will select all images between the clicked and focused image, or it will unselect all those images if the clicked image is already selected.</para>
+ </listitem>
+ <listitem>
+ <para><code>Shift + Ctrl</code> + Primary mouse button works as Shift + Primary mouse button, but will not change the selection of files outside the region between the focus and clicked image.</para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="Keyboard">
+ <title>Keyboard</title>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para><code>Ctrl + Arrows</code> will move the focus without changing the selection.</para>
+ </listitem>
+ <listitem>
+ <para><code>Ctrl + Space</code> will toggle selection of the focused image.</para>
+ </listitem>
+ <listitem>
+ <para><code>Shift + Arrows</code> will select a region of images.</para>
+ </listitem>
+ <listitem>
+ <para><code>Shift + Ctrl + Arrows</code> works as <code>Shift + Arrows</code>, but will not change the selection of files outside the current focus region.</para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ To select all files press <code>Ctrl + A</code>, or to unselect all image press <code>Ctrl + Shift + A</code>. These operations are also available from the
+ <emphasis role="bold">Edit</emphasis>
+ menu as
+ <emphasis role="bold">Select all</emphasis>
+ and
+ <emphasis role="bold">Select none</emphasis>
+ .
+ </para>
+ <para>
+ The current number of selected images and their total size will be indicated in the File list section of the
+ <link linkend="GuideMainWindowStatusBar">status bar</link>
+ .
+ </para>
+ <para />
+ </section>
+ </section>
+ <section id="Sorting">
+ <title>Sorting</title>
+ <para>The order of the images can be changed by clicking the sort area of the status bar or from the context menu. The sort methods are by file name, number, file date, or file size. The number method will sort file names by their natural order, for example files with names of file_10, file_12, and file_9 will appear in order file_9, file_10, and file_12.</para>
+ <para>Selecting the ascending menu item will toggle between increasing and decreasing sort order.</para>
+ <para />
+ </section>
+ <section id="Contextmenu">
+ <title>Context menu</title>
+ <para>
+ Right clicking the mouse or pressing the menu key while the file pane has focus will display a menu. The menu functions will perform the same as those that match the window's
+ <link linkend="GuideMainWindowMenus">menu bar</link>
+ , however a few functions are unique to the context menu:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <emphasis role="bold">View in new window</emphasis>
+ </term>
+ <listitem>
+ <para>Opens a new window containing a list of the currently selected images.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <emphasis role="bold">Sort</emphasis>
+ </term>
+ <listitem>
+ <para>Changes the sort order of file pane.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <emphasis role="bold">View as icons</emphasis>
+ </term>
+ <listitem>
+ <para>Toggles between the list and icon view modes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <emphasis role="bold">Show thumbnails</emphasis>
+ </term>
+ <listitem>
+ <para>Toggles display of thumbnails in the list view display mode.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <emphasis role="bold">Show filename text</emphasis>
+ </term>
+ <listitem>
+ <para>Toggles display of file names in the icon view display mode.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <emphasis role="bold">Show star rating</emphasis>
+ </term>
+ <listitem>
+ <para>Toggles display of the "star rating" (Xmp.xmp.Rating).</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="DragandDrop">
+ <title>Drag and Drop</title>
+ <para>Drag and drop can be initialized with the primary or middle mouse buttons in the file pane. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</para>
+ <para />
+ </section>
</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideMainWindowFolderPane">\r
- <title id="titleGuideMainWindowFolderPane">Folder pane</title>\r
- <para>The folder pane contains the menu bar, tool bar, path entry, and folder list.</para>\r
- <para />\r
- <section id="Menubar">\r
- <title>Menu bar</title>\r
- <para>\r
- The main menu of the window. The functions available from the main menu are described in the\r
- <link linkend="GuideMainWindowMenus">Menus</link>\r
- chapter.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Toolbar">\r
- <title>Tool bar</title>\r
- <para>\r
- The tool bar includes buttons for often used operations. The tool bar can be hidden or shown by selecting\r
- <emphasis role="bold">Hide toolbar</emphasis>\r
- from the\r
- <emphasis role="bold">View</emphasis>\r
- menu.\r
- </para>\r
- <table frame="all">\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead rowsep="1" colsep="1">\r
- <row>\r
- <entry>Icon</entry>\r
- <entry>Tooltip</entry>\r
- <entry>Description</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="icon_thumb.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Show thumbnails</entry>\r
- <entry>\r
- <para>This button is active when the file list is in list view mode, and activating it will toggle the display of thumbnails.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="go-previous.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Back</entry>\r
- <entry>\r
- <para>Move back in folder history</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="go-up.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Up</entry>\r
- <entry>\r
- <para>Move up one folder</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="user-home.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Home</entry>\r
- <entry>\r
- <para>Change the main window to display the contents of the user's home folder</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="view-refresh.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Refresh folder display</entry>\r
- <entry>\r
- <para>Refresh the contents of the file pane</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="zoom-in.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Zoom in</entry>\r
- <entry>\r
- <para>Increase the image display size.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="zoom-out.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Zoom out</entry>\r
- <entry>\r
- <para>Decrease the image display size.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="zoom-fit-best.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Zoom to fit</entry>\r
- <entry>\r
- <para>This will size the image to fit within the window</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="zoom-original.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Zoom 1:1</entry>\r
- <entry>\r
- <para>Restore zoom to the image's original size.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="preferences-desktop.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Preferences</entry>\r
- <entry>\r
- <para>\r
- Displays the\r
- <link linkend="GuideOptions">Preferences window</link>\r
- .\r
- </para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="icon_float.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Float file list</entry>\r
- <entry>\r
- <para>Toggle the folder pane, file pane, and status bar between the main window and a secondary window.</para>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <para />\r
- </section>\r
- <section id="Pathentry">\r
- <title>Path entry</title>\r
- <para>This displays the active folder of the window and allows typing a location.</para>\r
- <para>\r
- A folder or file can be typed into the entry to quickly change to a desired location or image, the main window will update after pressing the\r
- <code>Enter</code>\r
- key. Tab completion is also available in the path entry.\r
- </para>\r
- <note>\r
- <para>\r
- Tab completion uses the\r
- <keycode>Tab</keycode>\r
- key, press the\r
- <keycode>Down</keycode>\r
- key to move the focus from the entry.\r
- </para>\r
- </note>\r
- <para>Next to the path entry is a button with a down arrow, clicking this will display a drop down list containing the most recent locations viewed. The list is ordered such that the most recent location is at the top. Selecting a location from the drop down list will change the window to display the location.</para>\r
- <para>An Internet URL may be typed or drag-and-dropped into this field. The file will be downloaded to a temporary file and displayed.</para>\r
- <para />\r
- </section>\r
- <section id="Folderlist">\r
- <title>Folder list</title>\r
- <para>This pane consists of two sections: a folder pane and a shortcuts pane. The shortcuts pane may be hidden or revealed simply by moving the vertical divider to or from the extreme left.</para>\r
- <section id="folders">\r
- <title>Folders</title>\r
- <para>This displays a list of sub folders contained in the active folder, or a tree that includes all folders in the file system.</para>\r
- <para>\r
- A\r
- <emphasis role="strong">context menu</emphasis>\r
- can be displayed by clicking the right mouse button on the folder pane or pressing the menu key while the folder pane has the focus\r
- </para>\r
- </section>\r
- <section id="Shortcutslist">\r
- <title>Shortcuts</title>\r
- <para>This is a list of shortcuts (bookmarks) to commonly used folders, images and collections. A context menu will appear by right clicking on an item, or pressing the menu key when the item has the focus.</para>\r
- <para>Folders or images can be added to the list by activating the Add button at the bottom of the pane, or dragging a folder or image onto the list.</para>\r
- <para>\r
- Collections may be added by opening the\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>O</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Open collection...</guimenuitem>\r
- </menuchoice>\r
- dialog and dragging a collection onto the list.\r
- </para>\r
- <para>\r
- To edit an item select\r
- <emphasis role="bold">Properties</emphasis>\r
- from its context menu. A dialog will appear allowing the Name, Path, and Icon for the item to be changed. Select OK to close the dialog and apply the changes, or Cancel to close the dialog and discard the changes.\r
- </para>\r
- <para>\r
- To change the order of the list, select\r
- <emphasis role="bold">Move up</emphasis>\r
- or\r
- <emphasis role="bold">Move down</emphasis>\r
- from the item's context menu. To move an item with the keyboard move the focus to that item, then press\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>Up</keycap>\r
- </keycombo>\r
- or\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>Down</keycap>\r
- </keycombo>\r
- to move the item.\r
- </para>\r
- <para>\r
- To remove an item from the list select\r
- <emphasis role="bold">Remove</emphasis>\r
- from it's context menu.\r
- </para>\r
- <para />\r
- </section>\r
- </section>\r
- <section id="Listview">\r
- <title>List view</title>\r
- <para>\r
- This mode can be enabled by from the\r
- <emphasis role="bold">View</emphasis>\r
- menu, from the context menu, or pressing\r
- <code>Ctrl + T</code>\r
- .\r
- </para>\r
- <para>The list view mode displays sub folders contained in the active folder in a standard vertical list. The parent folder can be selected with the folder named “..”.</para>\r
- <para />\r
- </section>\r
- <section id="Treeview">\r
- <title>Tree view</title>\r
- <para>\r
- This mode can be enabled by selecting\r
- <emphasis role="bold">Tree</emphasis>\r
- from the View menu, pressing\r
- <code>Ctrl + T</code>\r
- , or selecting\r
- <emphasis role="bold">View as tree</emphasis>\r
- from the context menu.\r
- </para>\r
- <para>\r
- The tree view mode displays all folders in the file system, starting with the root folder and branching out to include sub folders. A folder branch can be expanded or collapsed by clicking the expander next to each folder icon, or by pressing the respective\r
- <code>+</code>\r
- or\r
- <code>-</code>\r
- keys when the folder branch has the focus.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Sorting">\r
- <title>Sorting</title>\r
- <para>The order of the folder names will match the order selected for the file pane. Sort order can be changed by clicking the sort area of the status bar or from the context menu of the file pane.</para>\r
- <para />\r
- </section>\r
- <section id="Contextmenu">\r
- <title>Context menu</title>\r
- <para>\r
- Right clicking the mouse or pressing the menu key while the folder pane has focus will display a menu. The menu functions will perform the same as those that match the window's\r
- <link linkend="GuideMainWindowMenus">menu bar</link>\r
- , however a few functions are unique to the context menu:\r
- </para>\r
- <table frame="all">\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead rowsep="1" colsep="1">\r
- <row>\r
- <entry>Icon</entry>\r
- <entry>Text</entry>\r
- <entry>Description</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="go-up.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Up to parent</entry>\r
- <entry>\r
- <para>This will change the window to display the contents of the parent folder.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>Slide show</entry>\r
- <entry>\r
- <para>\r
- Start a\r
- <link linkend="GuideImagePresentationSlideshow">slide show</link>\r
- that contains all images in the selected folder.\r
- </para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>Slide show recursive</entry>\r
- <entry>\r
- <para>\r
- Start a\r
- <link linkend="GuideImagePresentationSlideshow">slide show</link>\r
- that contains all images in the selected folder, and all images in the sub folders of that folder.\r
- </para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="edit-find.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Find duplicates</entry>\r
- <entry>\r
- <para>\r
- This will open a new\r
- <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>\r
- window containing all images in the selected folder.\r
- </para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="edit-find.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Find duplicates recursive</entry>\r
- <entry>\r
- <para>\r
- This will open a new\r
- <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>\r
- window containing all image in the selected folder, and all images in the sub folders of that folder.\r
- </para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>New folder</entry>\r
- <entry>\r
- <para>Creates a new folder that is a sub folder of the selected folder.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>Rename</entry>\r
- <entry>\r
- <para>Renames the selected folder.</para>\r
- <warning>\r
- <emphasis role="bold">Warning:</emphasis>\r
- Renaming a folder will not update metadata, such as keywords, or cached thumbnails for images contained in that folder, the data will be lost.\r
- </warning>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="edit-delete.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Delete</entry>\r
- <entry>\r
- <para>Delete file or folder</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>Copy path</entry>\r
- <entry>\r
- <para>\r
- Copy selected item-path(s) to clipboard\r
- <footnote id='ref1'>\r
- The clipboard used is selected\r
- <link linkend="Behaviour">here.</link>\r
- </footnote>\r
- . Each data item copied will be enclosed in quotes.\r
- </para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>Copy path unquoted</entry>\r
- <entry>\r
- <para>Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>View as list</entry>\r
- <entry>\r
- <para>Switches to list tree mode of the folder pane.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>View as tree</entry>\r
- <entry>\r
- <para>Switches to tree mode of the folder pane.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>Show hidden files</entry>\r
- <entry>\r
- <para>Switches to list tree mode of the folder pane.</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <guiicon>\r
- <inlinegraphic fileref="view-refresh.png" />\r
- </guiicon>\r
- </entry>\r
- <entry>Refresh</entry>\r
- <entry>\r
- <para>Switches to tree mode of the folder pane.</para>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <para />\r
- </section>\r
- <section id="Draganddrop">\r
- <title>Drag and drop</title>\r
- <para>Image files can be dropped onto folders displayed in the folder pane. A menu will appear allowing you to select to move or copy the dropped images into the target folder. The list will automatically scroll up or down when the drag pointer is near the respective top or bottom of the list. When in tree mode, hovering over a folder for a brief period of time will expand that folder.</para>\r
- <para>The folders can used as a drag source for drag and drop, for example to add images in a folder to a collection window. However drag and drop can not be used to move or copy folders in Geeqie.</para>\r
- <para>\r
- Using\r
- <code>Shift</code>\r
- key while dragging is a shortcut to move action. Menu will not appear but move will occur.\r
- </para>\r
- <para>\r
- Using\r
- <code>Ctrl</code>\r
- key while dragging is a shortcut to copy action. Menu will not appear but copy will occur.\r
- </para>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideMainWindowFolderPane">
+ <title id="titleGuideMainWindowFolderPane">Folder pane</title>
+ <para>The folder pane contains the menu bar, tool bar, path entry, and folder list.</para>
+ <para />
+ <section id="Menubar">
+ <title>Menu bar</title>
+ <para>
+ The main menu of the window. The functions available from the main menu are described in the
+ <link linkend="GuideMainWindowMenus">Menus</link>
+ chapter.
+ </para>
+ <para />
+ </section>
+ <section id="Toolbar">
+ <title>Tool bar</title>
+ <para>
+ The tool bar includes buttons for often used operations. The tool bar can be hidden or shown by selecting
+ <emphasis role="bold">Hide toolbar</emphasis>
+ from the
+ <emphasis role="bold">View</emphasis>
+ menu.
+ </para>
+ <table frame="all">
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead rowsep="1" colsep="1">
+ <row>
+ <entry>Icon</entry>
+ <entry>Tooltip</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="icon_thumb.png" />
+ </guiicon>
+ </entry>
+ <entry>Show thumbnails</entry>
+ <entry>
+ <para>This button is active when the file list is in list view mode, and activating it will toggle the display of thumbnails.</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="go-previous.png" />
+ </guiicon>
+ </entry>
+ <entry>Back</entry>
+ <entry>
+ <para>Move back in folder history</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="go-up.png" />
+ </guiicon>
+ </entry>
+ <entry>Up</entry>
+ <entry>
+ <para>Move up one folder</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="user-home.png" />
+ </guiicon>
+ </entry>
+ <entry>Home</entry>
+ <entry>
+ <para>Change the main window to display the contents of the user's home folder</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="view-refresh.png" />
+ </guiicon>
+ </entry>
+ <entry>Refresh folder display</entry>
+ <entry>
+ <para>Refresh the contents of the file pane</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="zoom-in.png" />
+ </guiicon>
+ </entry>
+ <entry>Zoom in</entry>
+ <entry>
+ <para>Increase the image display size.</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="zoom-out.png" />
+ </guiicon>
+ </entry>
+ <entry>Zoom out</entry>
+ <entry>
+ <para>Decrease the image display size.</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="zoom-fit-best.png" />
+ </guiicon>
+ </entry>
+ <entry>Zoom to fit</entry>
+ <entry>
+ <para>This will size the image to fit within the window</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="zoom-original.png" />
+ </guiicon>
+ </entry>
+ <entry>Zoom 1:1</entry>
+ <entry>
+ <para>Restore zoom to the image's original size.</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="preferences-desktop.png" />
+ </guiicon>
+ </entry>
+ <entry>Preferences</entry>
+ <entry>
+ <para>
+ Displays the
+ <link linkend="GuideOptions">Preferences window</link>
+ .
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="icon_float.png" />
+ </guiicon>
+ </entry>
+ <entry>Float file list</entry>
+ <entry>
+ <para>Toggle the folder pane, file pane, and status bar between the main window and a secondary window.</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para />
+ </section>
+ <section id="Pathentry">
+ <title>Path entry</title>
+ <para>This displays the active folder of the window and allows typing a location.</para>
+ <para>
+ A folder or file can be typed into the entry to quickly change to a desired location or image, the main window will update after pressing the
+ <code>Enter</code>
+ key. Tab completion is also available in the path entry.
+ </para>
+ <note>
+ <para>
+ Tab completion uses the
+ <keycode>Tab</keycode>
+ key, press the
+ <keycode>Down</keycode>
+ key to move the focus from the entry.
+ </para>
+ </note>
+ <para>Next to the path entry is a button with a down arrow, clicking this will display a drop down list containing the most recent locations viewed. The list is ordered such that the most recent location is at the top. Selecting a location from the drop down list will change the window to display the location.</para>
+ <para>An Internet URL may be typed or drag-and-dropped into this field. The file will be downloaded to a temporary file and displayed.</para>
+ <para />
+ </section>
+ <section id="Folderlist">
+ <title>Folder list</title>
+ <para>This pane consists of two sections: a folder pane and a shortcuts pane. The shortcuts pane may be hidden or revealed simply by moving the vertical divider to or from the extreme left.</para>
+ <section id="folders">
+ <title>Folders</title>
+ <para>This displays a list of sub folders contained in the active folder, or a tree that includes all folders in the file system.</para>
+ <para>
+ A
+ <emphasis role="strong">context menu</emphasis>
+ can be displayed by clicking the right mouse button on the folder pane or pressing the menu key while the folder pane has the focus
+ </para>
+ </section>
+ <section id="Shortcutslist">
+ <title>Shortcuts</title>
+ <para>This is a list of shortcuts (bookmarks) to commonly used folders, images and collections. A context menu will appear by right clicking on an item, or pressing the menu key when the item has the focus.</para>
+ <para>Folders or images can be added to the list by activating the Add button at the bottom of the pane, or dragging a folder or image onto the list.</para>
+ <para>
+ Collections may be added by opening the
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>O</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Open collection...</guimenuitem>
+ </menuchoice>
+ dialog and dragging a collection onto the list.
+ </para>
+ <para>
+ To edit an item select
+ <emphasis role="bold">Properties</emphasis>
+ from its context menu. A dialog will appear allowing the Name, Path, and Icon for the item to be changed. Select OK to close the dialog and apply the changes, or Cancel to close the dialog and discard the changes.
+ </para>
+ <para>
+ To change the order of the list, select
+ <emphasis role="bold">Move up</emphasis>
+ or
+ <emphasis role="bold">Move down</emphasis>
+ from the item's context menu. To move an item with the keyboard move the focus to that item, then press
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>Up</keycap>
+ </keycombo>
+ or
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>Down</keycap>
+ </keycombo>
+ to move the item.
+ </para>
+ <para>
+ To remove an item from the list select
+ <emphasis role="bold">Remove</emphasis>
+ from it's context menu.
+ </para>
+ <para />
+ </section>
+ </section>
+ <section id="Listview">
+ <title>List view</title>
+ <para>
+ This mode can be enabled by from the
+ <emphasis role="bold">View</emphasis>
+ menu, from the context menu, or pressing
+ <code>Ctrl + T</code>
+ .
+ </para>
+ <para>The list view mode displays sub folders contained in the active folder in a standard vertical list. The parent folder can be selected with the folder named “..”.</para>
+ <para />
+ </section>
+ <section id="Treeview">
+ <title>Tree view</title>
+ <para>
+ This mode can be enabled by selecting
+ <emphasis role="bold">Tree</emphasis>
+ from the View menu, pressing
+ <code>Ctrl + T</code>
+ , or selecting
+ <emphasis role="bold">View as tree</emphasis>
+ from the context menu.
+ </para>
+ <para>
+ The tree view mode displays all folders in the file system, starting with the root folder and branching out to include sub folders. A folder branch can be expanded or collapsed by clicking the expander next to each folder icon, or by pressing the respective
+ <code>+</code>
+ or
+ <code>-</code>
+ keys when the folder branch has the focus.
+ </para>
+ <para />
+ </section>
+ <section id="Sorting">
+ <title>Sorting</title>
+ <para>The order of the folder names will match the order selected for the file pane. Sort order can be changed by clicking the sort area of the status bar or from the context menu of the file pane.</para>
+ <para />
+ </section>
+ <section id="Contextmenu">
+ <title>Context menu</title>
+ <para>
+ Right clicking the mouse or pressing the menu key while the folder pane has focus will display a menu. The menu functions will perform the same as those that match the window's
+ <link linkend="GuideMainWindowMenus">menu bar</link>
+ , however a few functions are unique to the context menu:
+ </para>
+ <table frame="all">
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead rowsep="1" colsep="1">
+ <row>
+ <entry>Icon</entry>
+ <entry>Text</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="go-up.png" />
+ </guiicon>
+ </entry>
+ <entry>Up to parent</entry>
+ <entry>
+ <para>This will change the window to display the contents of the parent folder.</para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>Slide show</entry>
+ <entry>
+ <para>
+ Start a
+ <link linkend="GuideImagePresentationSlideshow">slide show</link>
+ that contains all images in the selected folder.
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>Slide show recursive</entry>
+ <entry>
+ <para>
+ Start a
+ <link linkend="GuideImagePresentationSlideshow">slide show</link>
+ that contains all images in the selected folder, and all images in the sub folders of that folder.
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="edit-find.png" />
+ </guiicon>
+ </entry>
+ <entry>Find duplicates</entry>
+ <entry>
+ <para>
+ This will open a new
+ <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>
+ window containing all images in the selected folder.
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="edit-find.png" />
+ </guiicon>
+ </entry>
+ <entry>Find duplicates recursive</entry>
+ <entry>
+ <para>
+ This will open a new
+ <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>
+ window containing all image in the selected folder, and all images in the sub folders of that folder.
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>New folder</entry>
+ <entry>
+ <para>Creates a new folder that is a sub folder of the selected folder.</para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>Rename</entry>
+ <entry>
+ <para>Renames the selected folder.</para>
+ <warning>
+ <emphasis role="bold">Warning:</emphasis>
+ Renaming a folder will not update metadata, such as keywords, or cached thumbnails for images contained in that folder, the data will be lost.
+ </warning>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="edit-delete.png" />
+ </guiicon>
+ </entry>
+ <entry>Delete</entry>
+ <entry>
+ <para>Delete file or folder</para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>Copy path</entry>
+ <entry>
+ <para>
+ Copy selected item-path(s) to clipboard
+ <footnote id='ref1'>
+ The clipboard used is selected
+ <link linkend="Behaviour">here.</link>
+ </footnote>
+ . Each data item copied will be enclosed in quotes.
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>Copy path unquoted</entry>
+ <entry>
+ <para>Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes.</para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>View as list</entry>
+ <entry>
+ <para>Switches to list tree mode of the folder pane.</para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>View as tree</entry>
+ <entry>
+ <para>Switches to tree mode of the folder pane.</para>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>Show hidden files</entry>
+ <entry>
+ <para>Switches to list tree mode of the folder pane.</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <guiicon>
+ <inlinegraphic fileref="view-refresh.png" />
+ </guiicon>
+ </entry>
+ <entry>Refresh</entry>
+ <entry>
+ <para>Switches to tree mode of the folder pane.</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para />
+ </section>
+ <section id="Draganddrop">
+ <title>Drag and drop</title>
+ <para>Image files can be dropped onto folders displayed in the folder pane. A menu will appear allowing you to select to move or copy the dropped images into the target folder. The list will automatically scroll up or down when the drag pointer is near the respective top or bottom of the list. When in tree mode, hovering over a folder for a brief period of time will expand that folder.</para>
+ <para>The folders can used as a drag source for drag and drop, for example to add images in a folder to a collection window. However drag and drop can not be used to move or copy folders in Geeqie.</para>
+ <para>
+ Using
+ <code>Shift</code>
+ key while dragging is a shortcut to move action. Menu will not appear but move will occur.
+ </para>
+ <para>
+ Using
+ <code>Ctrl</code>
+ key while dragging is a shortcut to copy action. Menu will not appear but copy will occur.
+ </para>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideMainWindowImagePane">\r
- <title id="titleGuideMainWindowImagePane">Image Pane</title>\r
- <para>The image pane is the region of the main window that displays the selected image. The image pane allows adjustment of display size and orientation; it also provides several methods to manipulate the image with the mouse and keyboard.</para>\r
- <para />\r
- <section id="Imagedisplay">\r
- <title>Image display</title>\r
- <para>The image is drawn to the screen as it is decoded from disk. The image can be panned and zoomed while it is still loading. Image adjustment operations for rotation, mirror, and flip will delay until the image is completed. The adjustment queue will remember one operation and will retain the most recently requested function, which will be performed once the image has finished loading.</para>\r
- <para>\r
- The quality of the image, especially when using the zoom feature, is dependent on the settings that are available on the\r
- <link linkend="GuideOptionsImage">Image tab</link>\r
- of the preferences dialog.\r
- </para>\r
- <para>\r
- To increase the speed of loading the next image when navigating the image list in sequence, enable the\r
- <link linkend="GuideOptionsImage">Preload next image</link>\r
- option.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="InformationandhistogramOverlay">\r
- <title id="titleInformationandhistogramOverlay">Image Overlay</title>\r
- <para>\r
- An image overlay can be turned on and off by repeatedly pressing\r
- <keycap>I</keycap>\r
- . This overlay can either display image data such as f-stop, shutter speed and descriptive text, or a histogram.\r
- </para>\r
- <para>\r
- Data the overlay will always show is:\r
- <itemizedlist>\r
- <listitem>\r
- <link linkend="GuideImageMarks">Marks</link>\r
- , if they are selected\r
- </listitem>\r
- </itemizedlist>\r
- </para>\r
- <para>\r
- If the histogram is being displayed,\r
- <keycap>K</keycap>\r
- will switch the histogram between colors, and\r
- <keycap>J</keycap>\r
- will toggle between a linear or logarithmic histogram.\r
- </para>\r
- <para>\r
- Data the overlay displays is customizable through the\r
- <link linkend="OverlayScreenDisplay">Image Overlay Template</link>\r
- option in the Windows tab in the Preferences dialog.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Imagepanningandmanipulation">\r
- <title>Image panning and manipulation</title>\r
- <para>When the image size is larger than the image pane, the visible region can be changed with the keyboard or mouse. The keyboard can also be used to adjust the orientation of the image.</para>\r
- <para />\r
- <section id="Keyboard">\r
- <title>Keyboard and mouse</title>\r
- <para>\r
- <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />\r
- describes how you may manipulate the image displayed.\r
- </para>\r
- <note>\r
- <para>\r
- The rotation, mirror, and flip functions do not change the image data, they merely change the image as you view it. You may store the modified orientation into metadata manually with\r
- <menuchoice>\r
- <guimenu>Edit</guimenu>\r
- <guimenuitem>Orientation</guimenuitem>\r
- <guimenuitem>Apply the orientation to image content</guimenuitem>\r
- </menuchoice>\r
- , or this may happen automatically if\r
- <emphasis>Write altered image orientation to the metadata</emphasis>\r
- is set in\r
- <link linkend="GuideOptionsMetadata">Metadata Options</link>\r
- </para>\r
- </note>\r
- <para />\r
- </section>\r
- <section id="Mouse">\r
- <title>Mouse</title>\r
- <para>\r
- Press the primary mouse button on the image and hold it, then move the mouse to pan the image in the desired direction. Releasing the mouse button will stop the panning operation. The mouse wheel can also be used to scroll the image when holding down the Shift key\r
- <footnote id='ref2'>\r
- The mouse wheel behavior for scrolling and image step can be swapped with the "Mouse wheel scrolls image" option located on the\r
- <link linkend="GuideOptionsBehavior">Behaviour tab</link>\r
- of the preferences dialog.\r
- </footnote>\r
- .\r
- </para>\r
- <para>To scale the image size hold down the Ctrl key and scroll the mouse wheel up to zoom in, or down to zoom out.</para>\r
- <para />\r
- <section id="SmoothScroll">\r
- <title>Smooth Scroll</title>\r
- <para>To start the smooth scroll function hold down the Shift key and click the primary mouse button. An icon will appear at the location of the mouse pointer, the mouse can then be positioned to pan the image. The image will pan in the direction of the mouse pointer relative to the icon. The pan speed will increase in proportion to the distance that the pointer is from the center of the icon. To end the smooth scroll function click the primary mouse button within the image pane.</para>\r
- <para />\r
- </section>\r
- <section id="MouseWheelMode">\r
- <title>Mouse Wheel Mode</title>\r
- <para>A single click on the mouse middle button will toggle the function of the mouse wheel between "change image" and "change zoom".</para>\r
- <note>\r
- <para>\r
- This option cannot be used if either the Preference\r
- <emphasis>Mouse wheel scrolls image</emphasis>\r
- or\r
- <emphasis>Navigation by left or middle click on image</emphasis>\r
- are selected.\r
- </para>\r
- </note>\r
- <para>In Split View mode, each window can be clicked individually so that, in Quad View for example, Connected Zoom can be on 2, 3 or all 4 windows.</para>\r
- </section>\r
- </section>\r
- </section>\r
- <section id="Navigation">\r
- <title>Navigation</title>\r
- <para>The displayed image can be changed to the next or previous image using the keyboard or mouse.</para>\r
- <para />\r
- <section id="Keyboard1">\r
- <title>Keyboard</title>\r
- <para>The PageDown and PageUp keys will change the image to the next or previous image, respectively, in the list. The Home and End keys will jump to the first and last image, respectively. When the image has the focus, the SpaceBar and BackSpace keys can also be used to change the image.</para>\r
- <para />\r
- </section>\r
- <section id="Mouse1">\r
- <title>Mouse</title>\r
- <para>\r
- To change to the next image in the list click the left mouse button, click the middle mouse button to change to the previous image. The mouse wheel can also be used to change the current image\r
- <footnoteref linkend='ref2' />\r
- .\r
- </para>\r
- <para />\r
- </section>\r
- </section>\r
- <section id="Contextmenu">\r
- <title>Context menu</title>\r
- <para>\r
- Right clicking the mouse or pressing the menu key while the image has the focus will display a menu. The menu functions will perform the same as those that match the window's\r
- <link linkend="GuideMainWindowMenus">menu bar</link>\r
- , however a few functions are unique to the context menu:\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>View in new window</term>\r
- <listitem>\r
- <para>Opens a new window containing a second copy of the current image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>Pause slide show, Continue slide show</term>\r
- <listitem>\r
- <para>Controls the pause state of an active slide show, the text of the menu will change to reflect the action that will be performed.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="ImagePaneDragandDrop">\r
- <title id="titleImagePaneDragandDrop">Drag and Drop</title>\r
- <para>Files and folders can be dropped onto the image pane, dropping a file will display the file and dropping a folder will change the main window to display the contents of the folder. When dropping multiple items on the image pane, only the first item in the list will be used, all additional items will be ignored.</para>\r
- <para>A drag and drop operation can be initiated from the image pane with the middle mouse button, the dragged item will contain the file path of the displayed image.</para>\r
- <para />\r
- </section>\r
- <section id="Displayingimagessidebyside">\r
- <title>Displaying images side by side</title>\r
- <para>Using View > Split item from the main menu, image pane can be split into either two or four panes, allowing one to display images side by side. You may use drag'n drop to change images in each pane.</para>\r
- <para>\r
- Connected zoom is possible through the\r
- <emphasis role="bold">View▸Zoom▸Connected Zoom</emphasis>\r
- menu item. Zoom is then applied to all displayed images.\r
- </para>\r
- <para>Connected scrolling is also possible using Shift and primary mouse button.</para>\r
- <para>As a general rule, hotkeys and mouse without shift affects just one image and with shift all images.</para>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideMainWindowImagePane">
+ <title id="titleGuideMainWindowImagePane">Image Pane</title>
+ <para>The image pane is the region of the main window that displays the selected image. The image pane allows adjustment of display size and orientation; it also provides several methods to manipulate the image with the mouse and keyboard.</para>
+ <para />
+ <section id="Imagedisplay">
+ <title>Image display</title>
+ <para>The image is drawn to the screen as it is decoded from disk. The image can be panned and zoomed while it is still loading. Image adjustment operations for rotation, mirror, and flip will delay until the image is completed. The adjustment queue will remember one operation and will retain the most recently requested function, which will be performed once the image has finished loading.</para>
+ <para>
+ The quality of the image, especially when using the zoom feature, is dependent on the settings that are available on the
+ <link linkend="GuideOptionsImage">Image tab</link>
+ of the preferences dialog.
+ </para>
+ <para>
+ To increase the speed of loading the next image when navigating the image list in sequence, enable the
+ <link linkend="GuideOptionsImage">Preload next image</link>
+ option.
+ </para>
+ <para />
+ </section>
+ <section id="InformationandhistogramOverlay">
+ <title id="titleInformationandhistogramOverlay">Image Overlay</title>
+ <para>
+ An image overlay can be turned on and off by repeatedly pressing
+ <keycap>I</keycap>
+ . This overlay can either display image data such as f-stop, shutter speed and descriptive text, or a histogram.
+ </para>
+ <para>
+ Data the overlay will always show is:
+ <itemizedlist>
+ <listitem>
+ <link linkend="GuideImageMarks">Marks</link>
+ , if they are selected
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ If the histogram is being displayed,
+ <keycap>K</keycap>
+ will switch the histogram between colors, and
+ <keycap>J</keycap>
+ will toggle between a linear or logarithmic histogram.
+ </para>
+ <para>
+ Data the overlay displays is customizable through the
+ <link linkend="OverlayScreenDisplay">Image Overlay Template</link>
+ option in the Windows tab in the Preferences dialog.
+ </para>
+ <para />
+ </section>
+ <section id="Imagepanningandmanipulation">
+ <title>Image panning and manipulation</title>
+ <para>When the image size is larger than the image pane, the visible region can be changed with the keyboard or mouse. The keyboard can also be used to adjust the orientation of the image.</para>
+ <para />
+ <section id="Keyboard">
+ <title>Keyboard and mouse</title>
+ <para>
+ <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />
+ describes how you may manipulate the image displayed.
+ </para>
+ <note>
+ <para>
+ The rotation, mirror, and flip functions do not change the image data, they merely change the image as you view it. You may store the modified orientation into metadata manually with
+ <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Orientation</guimenuitem>
+ <guimenuitem>Apply the orientation to image content</guimenuitem>
+ </menuchoice>
+ , or this may happen automatically if
+ <emphasis>Write altered image orientation to the metadata</emphasis>
+ is set in
+ <link linkend="GuideOptionsMetadata">Metadata Options</link>
+ </para>
+ </note>
+ <para />
+ </section>
+ <section id="Mouse">
+ <title>Mouse</title>
+ <para>
+ Press the primary mouse button on the image and hold it, then move the mouse to pan the image in the desired direction. Releasing the mouse button will stop the panning operation. The mouse wheel can also be used to scroll the image when holding down the Shift key
+ <footnote id='ref2'>
+ The mouse wheel behavior for scrolling and image step can be swapped with the "Mouse wheel scrolls image" option located on the
+ <link linkend="GuideOptionsBehavior">Behaviour tab</link>
+ of the preferences dialog.
+ </footnote>
+ .
+ </para>
+ <para>To scale the image size hold down the Ctrl key and scroll the mouse wheel up to zoom in, or down to zoom out.</para>
+ <para />
+ <section id="SmoothScroll">
+ <title>Smooth Scroll</title>
+ <para>To start the smooth scroll function hold down the Shift key and click the primary mouse button. An icon will appear at the location of the mouse pointer, the mouse can then be positioned to pan the image. The image will pan in the direction of the mouse pointer relative to the icon. The pan speed will increase in proportion to the distance that the pointer is from the center of the icon. To end the smooth scroll function click the primary mouse button within the image pane.</para>
+ <para />
+ </section>
+ <section id="MouseWheelMode">
+ <title>Mouse Wheel Mode</title>
+ <para>A single click on the mouse middle button will toggle the function of the mouse wheel between "change image" and "change zoom".</para>
+ <note>
+ <para>
+ This option cannot be used if either the Preference
+ <emphasis>Mouse wheel scrolls image</emphasis>
+ or
+ <emphasis>Navigation by left or middle click on image</emphasis>
+ are selected.
+ </para>
+ </note>
+ <para>In Split View mode, each window can be clicked individually so that, in Quad View for example, Connected Zoom can be on 2, 3 or all 4 windows.</para>
+ </section>
+ </section>
+ </section>
+ <section id="Navigation">
+ <title>Navigation</title>
+ <para>The displayed image can be changed to the next or previous image using the keyboard or mouse.</para>
+ <para />
+ <section id="Keyboard1">
+ <title>Keyboard</title>
+ <para>The PageDown and PageUp keys will change the image to the next or previous image, respectively, in the list. The Home and End keys will jump to the first and last image, respectively. When the image has the focus, the SpaceBar and BackSpace keys can also be used to change the image.</para>
+ <para />
+ </section>
+ <section id="Mouse1">
+ <title>Mouse</title>
+ <para>
+ To change to the next image in the list click the left mouse button, click the middle mouse button to change to the previous image. The mouse wheel can also be used to change the current image
+ <footnoteref linkend='ref2' />
+ .
+ </para>
+ <para />
+ </section>
+ </section>
+ <section id="Contextmenu">
+ <title>Context menu</title>
+ <para>
+ Right clicking the mouse or pressing the menu key while the image has the focus will display a menu. The menu functions will perform the same as those that match the window's
+ <link linkend="GuideMainWindowMenus">menu bar</link>
+ , however a few functions are unique to the context menu:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>View in new window</term>
+ <listitem>
+ <para>Opens a new window containing a second copy of the current image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Pause slide show, Continue slide show</term>
+ <listitem>
+ <para>Controls the pause state of an active slide show, the text of the menu will change to reflect the action that will be performed.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="ImagePaneDragandDrop">
+ <title id="titleImagePaneDragandDrop">Drag and Drop</title>
+ <para>Files and folders can be dropped onto the image pane, dropping a file will display the file and dropping a folder will change the main window to display the contents of the folder. When dropping multiple items on the image pane, only the first item in the list will be used, all additional items will be ignored.</para>
+ <para>A drag and drop operation can be initiated from the image pane with the middle mouse button, the dragged item will contain the file path of the displayed image.</para>
+ <para />
+ </section>
+ <section id="Displayingimagessidebyside">
+ <title>Displaying images side by side</title>
+ <para>Using View > Split item from the main menu, image pane can be split into either two or four panes, allowing one to display images side by side. You may use drag'n drop to change images in each pane.</para>
+ <para>
+ Connected zoom is possible through the
+ <emphasis role="bold">View▸Zoom▸Connected Zoom</emphasis>
+ menu item. Zoom is then applied to all displayed images.
+ </para>
+ <para>Connected scrolling is also possible using Shift and primary mouse button.</para>
+ <para>As a general rule, hotkeys and mouse without shift affects just one image and with shift all images.</para>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideMainWindowLayout">\r
- <title id="titleGuideMainWindowLayout">Layout</title>\r
- <para>\r
- The main window consists of four areas, the\r
- <link linkend="GuideMainWindowFolderPane">folder pane</link>\r
- ,\r
- <link linkend="GuideMainWindowFilePane">file pane</link>\r
- ,\r
- <link linkend="GuideMainWindowImagePane">image pane</link>\r
- , and the\r
- <link linkend="GuideMainWindowStatusBar">status bar</link>\r
- . The status bar is always at the bottom of the window. The three remaining areas, or panes, can be arranged and sized by the user.\r
- </para>\r
- <para />\r
- <section id="Selectingthelocationofeachpane">\r
- <title>Selecting the location of each pane</title>\r
- <para>\r
- The arrangement of the folder, file, and image pane is selected on the\r
- <link linkend="GuideOptionsLayout" endterm="titleGuideOptionsLayout" />\r
- dialogue.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Changingthesizeofapane">\r
- <title>Changing the size of a pane</title>\r
- <para>Between the panes of the main window are two dividers that can be moved with the mouse to adjust the size of each pane. Press and hold the primary button, then move the divider to the desired location and release the button.</para>\r
- <para />\r
- <section id="Folderpane">\r
- <title>Folder pane</title>\r
- <para>\r
- The\r
- <link linkend="GuideMainWindowFolderPane">folder pane</link>\r
- contains the menu bar, tool bar, path entry, and folder list. The list can be set to display the sub folders of the active folder or a tree that starts with the root folder and contains all folders in the file system.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Filepane">\r
- <title>File pane</title>\r
- <para>\r
- The\r
- <link linkend="GuideMainWindowFilePane">file pane</link>\r
- lists the images contained in the active folder. The file pane can be set to display as a vertical list or an icon view.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Imagepane">\r
- <title>Image pane</title>\r
- <para>\r
- The\r
- <link linkend="GuideMainWindowImagePane">image pane</link>\r
- is where the active image is displayed.\r
- </para>\r
- <para />\r
- </section>\r
- </section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideMainWindowLayout">
+ <title id="titleGuideMainWindowLayout">Layout</title>
+ <para>
+ The main window consists of four areas, the
+ <link linkend="GuideMainWindowFolderPane">folder pane</link>
+ ,
+ <link linkend="GuideMainWindowFilePane">file pane</link>
+ ,
+ <link linkend="GuideMainWindowImagePane">image pane</link>
+ , and the
+ <link linkend="GuideMainWindowStatusBar">status bar</link>
+ . The status bar is always at the bottom of the window. The three remaining areas, or panes, can be arranged and sized by the user.
+ </para>
+ <para />
+ <section id="Selectingthelocationofeachpane">
+ <title>Selecting the location of each pane</title>
+ <para>
+ The arrangement of the folder, file, and image pane is selected on the
+ <link linkend="GuideOptionsLayout" endterm="titleGuideOptionsLayout" />
+ dialogue.
+ </para>
+ <para />
+ </section>
+ <section id="Changingthesizeofapane">
+ <title>Changing the size of a pane</title>
+ <para>Between the panes of the main window are two dividers that can be moved with the mouse to adjust the size of each pane. Press and hold the primary button, then move the divider to the desired location and release the button.</para>
+ <para />
+ <section id="Folderpane">
+ <title>Folder pane</title>
+ <para>
+ The
+ <link linkend="GuideMainWindowFolderPane">folder pane</link>
+ contains the menu bar, tool bar, path entry, and folder list. The list can be set to display the sub folders of the active folder or a tree that starts with the root folder and contains all folders in the file system.
+ </para>
+ <para />
+ </section>
+ <section id="Filepane">
+ <title>File pane</title>
+ <para>
+ The
+ <link linkend="GuideMainWindowFilePane">file pane</link>
+ lists the images contained in the active folder. The file pane can be set to display as a vertical list or an icon view.
+ </para>
+ <para />
+ </section>
+ <section id="Imagepane">
+ <title>Image pane</title>
+ <para>
+ The
+ <link linkend="GuideMainWindowImagePane">image pane</link>
+ is where the active image is displayed.
+ </para>
+ <para />
+ </section>
+ </section>
</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideMainWindowMenus">\r
- <title id="titleGuideMainWindowMenus">Menus</title>\r
- <para>This section describes the functions of each item on the menu bar in the Geeqie main window.</para>\r
- <para />\r
- <section id="FileMenu">\r
- <title>File Menu</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>N</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>New window</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a new main window, with the initial path set to the current folder.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>C</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>New collection</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a new collection window, the new collection will be empty.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>O</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Open collection</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Displays a dialog to open a collection stored on disk, the selected collection will then appear in a new window.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Open recent</guimenu>\r
- </term>\r
- <listitem>\r
- <para>\r
- This menu item lists the recently active collections, selecting an item from the list will open that collection in a new window. The most recent item will appear at the top of the list. Maximum number of entries can be modified through\r
- <link linkend="Behaviour">Open recent list maximum size</link>\r
- option.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>F3</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Search…</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a new Search window.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>D</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Find duplicates...</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a new Find Duplicates window.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>P</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Print..</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a print dialog.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>F</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>New folder…</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Creates a new folder in the current path.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>C</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Copy…</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a dialog to select a destination to copy the currently selected files.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>M</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Move…</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a dialog to select a destination to move currently selected files.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>R</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Rename…</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Renames the current file selection.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>D</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Delete…</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Deletes the current file selection.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Symlink</guimenu>\r
- </term>\r
- <listitem>\r
- <para>\r
- Creates a symbolic link. This is implemented via a\r
- <link linkend="GuideImageManagementPlugins">plugin</link>\r
- .\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>W</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Close window</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Closes the window containing the menu, if the window is the last main window Geeqie will quit.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>Q</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Quit</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Quits the Geeqie application, if collections or image metadata have been changed but not saved, the user will be prompted for confirmation.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Gomenu">\r
- <title>Go menu</title>\r
- <para>The Page commands are for files which contain multiple images e.g. .tiff files</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Home</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>First Image</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Goes to the first image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Backspace</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Previous Image</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Goes to the previous image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Space</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Next Image</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Goes to the next image</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>End</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Last Image</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Goes to the last image</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Image Back</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Each image you view is appended to a chain. You may traverse forwards and backwards through this chain using this and the following key. Move to the previous image in the chain.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Image Forward</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Move to the next image in the chain.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Back</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Back Goes to the previous folder</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Home</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Home</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Goes to the the Home folder as defined in\r
- <link linkend="GuideOptionsLayout" endterm="titleGuideOptionsLayout" />\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>Home</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>First Page</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Goes to the first page.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>End</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Last Page</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Goes to the last page.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>PageUp</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Previous Page</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Goes to the previous page.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>PageDown</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Next Page</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Goes to the next page.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Selectmenu">\r
- <title>Select menu</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>A</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Select all</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Selects all files in the current list</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>Shift</keycap>\r
- <keycap>A</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Select none</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Deselects all files</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>Shift</keycap>\r
- <keycap>I</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Invert selection</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Inverts current selection</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Alt</keycap>\r
- <keycap>R</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Rectangular selection</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Toggles rectangular selection mode for icons</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Copy path</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Copy selected item-path(s) to clipboard\r
- <footnote id='ref1'>\r
- The clipboard used is selected\r
- <link linkend="Behaviour">here.</link>\r
- </footnote>\r
- . Each data item copied will be enclosed in quotes.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Copy path unquoted</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>M</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Show marks</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Displays marks in the file list</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Clear marks</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Clear all marks for all images</para>\r
- <warning>\r
- <para>Marks that are linked to keywords will also be cleared. This may result in a metadata write operation being triggered.</para>\r
- </warning>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Mark n</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens submenu for manipulating mark n</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>n</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Mark n</guimenu>\r
- <guimenuitem>Toggle Mark n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Set or unset mark n on selected files</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Mark n</guimenu>\r
- <guimenuitem>Set mark n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Set mark n on selected files</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Mark n</guimenu>\r
- <guimenuitem>Reset mark n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Unset mark n on selected files</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>n</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Mark n</guimenu>\r
- <guimenuitem>Select mark n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Selects all files having mark n set</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Mark n</guimenu>\r
- <guimenuitem>Add mark n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Adds files having mark n set to selection</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Mark n</guimenu>\r
- <guimenuitem>Intersection with mark n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Intersects current selection and mark n</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Mark n</guimenu>\r
- <guimenuitem>Unselect mark n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Removes files having mark n set from current selection</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Mark n</guimenu>\r
- <guimenuitem>Filter mark n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Shows only the images that have mark n set.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Editmenu">\r
- <title>Edit menu</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Orientation</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Adjust image orientation</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>]</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Rotate clockwise</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Rotates the current image clockwise 90 degrees, does not modify the file on disk.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>[</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Rotate counterclockwise</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>R</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Rotate 180</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Rotates the current image 180 degrees, does not modify the file on disk.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>M</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Mirror</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Swaps the left and right sides of the image so that the result is similar to that of looking at the image in a mirror, does not modify the file on disk.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>F</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Flip</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Swaps the top and bottom sides of the image, does not modify the file on disk.</para>\r
- <warning>\r
- <para>\r
- The above orientation commands - Rotate, Mirror and Flip - do not change the image on disk. The changes will be lost when Geeqie closes. Refer to the\r
- <link linkend="MetadataMiscellaneous">Metadata tab of the Preferences Dialog</link>\r
- if you wish these changes to be written to metadata.\r
- </para>\r
- <para>\r
- Refer also to the\r
- <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>\r
- .\r
- </para>\r
- </warning>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>O</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Original state</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Removes all temporary effects applied through the above commands, reverting the image according to its Exif Orientation tag.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Auto rotate image using EXIF information</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Auto rotates images based on metadata stored in images that have Exif data. Refer also to the\r
- <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>\r
- .\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Apply the orientation to image content</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>This command affects only jpeg, tiff and png files. The image file on disk is rotated to the orientation as specified by its Exif Orientation tag.</para>\r
- <warning>\r
- <para>\r
- The file rotate.desktop, using external commands exiftran, exiv2 and mogrify, is used to implement this command. Refer to\r
- <link linkend="GuideImageManagementPlugins">Plugins section</link>\r
- for details.\r
- </para>\r
- </warning>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>[</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Rotate counterclockwise</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>R</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Rotate 180</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Rotates the current image 180 degrees, does not modify the file on disk.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Write orientation to file</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Saves the current image orientation to the disk file. This operation can only be carried out on jpeg, tiff and png files. Jpeg rotations are lossless.\r
- <note>\r
- The Preferences/Metadata option "Write altered image orientation to the metadata" must be off.\r
- <para />\r
- Exiftran and mogrify must be installed.\r
- </note>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Orientation</guimenu>\r
- <guimenuitem>Write orientation to file (preserve timestamp)</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>As above, but the file date and time are preserved.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Rating</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Set a Rating value for each image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Alt+Keypad+n</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Rating</guimenu>\r
- <guimenuitem>n</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>"n" is in the range 0 to 5. Sets the Rating value for the image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Alt+Keypad+Minus</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Rating</guimenu>\r
- <guimenuitem>-1</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Sets the Rating value to -1 for the image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>S</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Save metadata</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Saves queued metadata changes. Autosave can be configured too.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>O</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Preferences</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Opens the\r
- <link linkend="GuideOptions">Preferences Dialog</link>\r
- for changing of global preferences.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Configure Plugins…</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Opens the\r
- <link linkend="GuideImageManagementPlugins">Plugins Dialog</link>\r
- for changing of desktop files.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Configure This window…</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Opens the\r
- <link linkend="GuideOptionsWindow">Window Preferences Dialog</link>\r
- for changing of options that can differ for each window.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Cache maintenance</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Opens a dialog with utilities for thumbnail and keyword\r
- <link linkend="GuideReferenceManagement" endterm="titleGuideReferenceManagement" />\r
- .\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Set as wallpaper</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Renders the current image to the root window (desktop). The resulting image will be tiled to fit the root window if zoom is not set to\r
- <emphasis role="i">Fit to window</emphasis>\r
- ; when zoom is set to\r
- <emphasis role="i">Fit to window</emphasis>\r
- , the image will be scaled to fill the root window.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Pluginsmenu">\r
- <title>Plugins menu</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Plugins</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- This menu contains the plugins (desktop files) that were found on the system. See the\r
- <link linkend="GuideImageManagementPlugins">Plugins section</link>\r
- for details.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Viewmenu">\r
- <title>View menu</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>V</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>View in new window</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens selected image in its own window</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>J</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Pan view</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens current folder in Pan view window</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>E</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Exif data</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Toggles display of the Exif sidebar.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Meta</keycap>\r
- <keycap>L</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Files and Folders</guimenu>\r
- <guimenu>Folder List</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Set the folder view mode to list.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>T</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Files and Folders</guimenu>\r
- <guimenuitem>Folder Tree</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Set the folder view mode to tree.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>L</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Files and Folders</guimenu>\r
- <guimenuitem>Image List</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Changes the file list to display files in list format.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>I</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Files and Folders</guimenu>\r
- <guimenuitem>Icons</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Changes the file list to display files as icons.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Files and Folders</guimenu>\r
- <guimenuitem>Show Thumbnails</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Toggles the display of image thumbnails in the file list, this item is not available when the file list is in icon view mode. A check appears next to this item when thumbnails are enabled.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>L</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Files and Folders</guimenu>\r
- <guimenuitem>Float file list</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Splits the 3-pane main window into two parts:\r
- <itemizedlist>\r
- <listitem>File pane and Folder pane, along with menu and status bar</listitem>\r
- <listitem>Image pane and its associated sidebar and sort manager (if displayed)</listitem>\r
- </itemizedlist>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>H</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Files and Folders</guimenu>\r
- <guimenuitem>Hide file list</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Hides the File and Folder panes, along with menu and status bar.\r
- <code>Right-click</code>\r
- on the Image pane provides a menu item to redisplay these items.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Files and Folders</guimenu>\r
- <guimenuitem>Hide toolbar</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Toggles visibility of the tool bar. A check appears next to this item when the tool bar is not visible.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Zoom</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para />\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Zoom</guimenu>\r
- <guimenuitem>Connected zoom</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Actions in this menu are identical to those in\r
- <emphasis role="bold">Zoom</emphasis>\r
- menu, but apply to all images displayed in split view.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Zoom</guimenu>\r
- <guimenuitem>Zoom in</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Increases the zoom by one increment, resulting in a larger image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Zoom</guimenu>\r
- <guimenuitem>Zoom out</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Decreases the zoom by one increment, resulting in a smaller image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Zoom</guimenu>\r
- <guimenuitem>Zoom to fit</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Automatically adjusts the zoom so that the image will fit within the display pane. The effect on images with an original size smaller than the display pane can be changed with the\r
- <emphasis>Allow enlargement of image for zoom to fit</emphasis>\r
- option located on the\r
- <link linkend="GuideOptionsImage">Image tab</link>\r
- of the preferences dialog.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Zoom</guimenu>\r
- <guimenuitem>Fit Horizontally</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Adjusts the zoom so image height fit within the display pane.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Zoom</guimenu>\r
- <guimenuitem>Fit Vertically</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Adjusts the zoom so image width fit within the display pane.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="document-new.png" />\r
- </guiicon>\r
- New\r
- </guibutton>\r
- </code>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Z</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Zoom</guimenu>\r
- <guimenuitem>Zoom n:m</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Set zoom to the n:m value. 1:1 is the original size of the image. When n is greater than m, zoom in occurs else zoom out occurs.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Z</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Zoom</guimenu>\r
- <guimenuitem>Zoom n:m</guimenuitem>\r
- </menuchoice>\r
- <guimenu>Split</guimenu>\r
- </term>\r
- <listitem>\r
- <para />\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Split</guimenu>\r
- <guimenuitem>Horizontal</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Splits main image view in two horizontal panes.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>U</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Split</guimenu>\r
- <guimenuitem>Vertical</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Splits main image view in two vertical panes.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Split</guimenu>\r
- <guimenuitem>Quad</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Splits main image view in four panes.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Y</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Split</guimenu>\r
- <guimenuitem>Single</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Reverts to normal view mode (one image).</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist />\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Image Overlay</guimenu>\r
- <guimenu>Image Overlay</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Displays Image Overlay information box (OSD), use twice to add histogram to it.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Image Overlay</guimenu>\r
- <guimenu>Histogram channels</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Switches channels displayed in the histogram (red, green, blue, RGB, value, maximum value).</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Image Overlay</guimenu>\r
- <guimenu>Histogram log mode</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Toggles between linear and logarithmical histogram.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Full screen</guimenu>\r
- </term>\r
- <listitem>\r
- <para>Toggles the full screen window display.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>E</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Over/Under Exposure</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Toggles highlighting of pixels that are either over or under exposed. This function operates on the displayed pixels. If a raw file is being displayed, the embedded jpeg data is being used. If the image is zoomed, the zoom type affects the results. Two-pass rendering also has some influence.\r
- <para />\r
- If a pixel has any channel at zero or full-scale, the pixel is displayed in red.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Keywords</guimenu>\r
- </term>\r
- <listitem>\r
- <para>Toggles display of the Keywords sidebar.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Sort manager</guimenu>\r
- </term>\r
- <listitem>\r
- <para>Toggles display of the Sort Manager sidebar.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Hide Bars</guimenu>\r
- </term>\r
- <listitem>\r
- <para>This item is intended to be used by its shortcut key - by default this is the backtick key. When pressed, the info sidebar, sort manager and file list will be hidden (if displayed). Pressing backtick again will revert the display to its previous layout.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Toggle slideshow</guimenu>\r
- </term>\r
- <listitem>\r
- <para>Begins or ends a slide show, the slide show status is displayed in the status bar.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Pause slideshow</guimenu>\r
- </term>\r
- <listitem>\r
- <para>Pauses a slide show, the slide show status is displayed in the status bar.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Faster</guimenu>\r
- </term>\r
- <listitem>\r
- <para>Decreases slide show interval in units of 0.5 seconds.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Slower</guimenu>\r
- </term>\r
- <listitem>\r
- <para>Increases slide show interval in units of 0.5 seconds.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guimenu>Refresh</guimenu>\r
- </term>\r
- <listitem>\r
- <para>Updates the contents of the folder and file lists to match what is currently on disk, the current image will also be reread from disk.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Windowmenu">\r
- <title>Windows menu</title>\r
- <para>This menu permits you to define several different window layouts that can be recalled at any time.</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>N</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>New window</guimenu>\r
- <guimenuitem>default</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a new window with the default layout. The window is given a name in the form "lw<n>".</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>New window</guimenu>\r
- <guimenuitem>from current</guimenuitem>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a new window with the layout of the window that has focus. The window is given a name in the form "lw<n>".</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Rename window</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>If a window is given a name that does not begin with the characters "lw", the layout will be saved and be available for loading at a later time..</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Delete window</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Delete a saved window layout from the list.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Close window</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Close the window. If the window is the "main" window, close all windows.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Helpmenu">\r
- <title>Help menu</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>F1</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Contents</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens the Geeqie user manual in a new browser window.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>/</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Search and Run Commands</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Opens a text box in which you may type characters to find a command. The characters you type will be matched to the first characters of any word in all the commands in Geeqie - both built-in commands and plugins - and matching actions will be displayed in a pop-up. You may scroll to any of the matching commands and press\r
- <code>Enter</code>\r
- to execute the command. Pressing\r
- <code>Enter</code>\r
- without selecting from the list will execute the first action in the list. Press\r
- <code>Esc</code>\r
- to close the box.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>On-line help search</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>\r
- Use a web browser to search Geeqie's on-line help files. The search engine used is defined in\r
- <link linkend="OnLineHelpSearch">Preferences General</link>\r
- .\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Keyboard shortcuts</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Displays a window listing the default keyboard shortcuts.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Keyboard Map</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Displays an image showing the currently allocated keyboard shortcuts.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Release notes</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Displays a window containing the release notes for the version of Geeqie in use.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>About</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens a window containing the Geeqie version, credits, website, and email contact information.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <menuchoice>\r
- <guimenu>Log window</guimenu>\r
- </menuchoice>\r
- </term>\r
- <listitem>\r
- <para>Opens the log window, mostly used for debugging purposes.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Tearoffmenus">\r
- <title>Tear off menus</title>\r
- <para>Menus can be permanently displayed by selecting the dotted line item at the top of each menu category. A tear off menu will behave the same as an ordinary window. To close a tear off menu, select the dotted line item at the top of the menu.</para>\r
- <para />\r
- </section>\r
- <section id="Keyboardshortcuts">\r
- <title>Keyboard shortcuts</title>\r
- <para>\r
- The keyboard sequence associated to each menu entry is listed within the main window menu bar. For reference, the complete list of default keyboard shortcuts can be found in section\r
- <link linkend="GuideReferenceKeyboardShortcuts">Keyboard Shortcuts</link>\r
- .\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Changingthemainwindowmenubarkeyboardshortcuts">\r
- <title>Changing the main window menu bar keyboard shortcuts</title>\r
- <para>\r
- The section\r
- <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />\r
- describes how to modify the keyboard shortcuts used in the main menu.\r
- </para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideMainWindowMenus">
+ <title id="titleGuideMainWindowMenus">Menus</title>
+ <para>This section describes the functions of each item on the menu bar in the Geeqie main window.</para>
+ <para />
+ <section id="FileMenu">
+ <title>File Menu</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>N</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>New window</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a new main window, with the initial path set to the current folder.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>C</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>New collection</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a new collection window, the new collection will be empty.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>O</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Open collection</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Displays a dialog to open a collection stored on disk, the selected collection will then appear in a new window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Open recent</guimenu>
+ </term>
+ <listitem>
+ <para>
+ This menu item lists the recently active collections, selecting an item from the list will open that collection in a new window. The most recent item will appear at the top of the list. Maximum number of entries can be modified through
+ <link linkend="Behaviour">Open recent list maximum size</link>
+ option.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>F3</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Search…</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a new Search window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>D</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Find duplicates...</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a new Find Duplicates window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>P</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Print..</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a print dialog.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>F</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>New folder…</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Creates a new folder in the current path.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>C</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Copy…</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a dialog to select a destination to copy the currently selected files.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>M</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Move…</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a dialog to select a destination to move currently selected files.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>R</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Rename…</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Renames the current file selection.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>D</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Delete…</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Deletes the current file selection.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Symlink</guimenu>
+ </term>
+ <listitem>
+ <para>
+ Creates a symbolic link. This is implemented via a
+ <link linkend="GuideImageManagementPlugins">plugin</link>
+ .
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>W</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Close window</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Closes the window containing the menu, if the window is the last main window Geeqie will quit.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>Q</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Quit</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Quits the Geeqie application, if collections or image metadata have been changed but not saved, the user will be prompted for confirmation.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Gomenu">
+ <title>Go menu</title>
+ <para>The Page commands are for files which contain multiple images e.g. .tiff files</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Home</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>First Image</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Goes to the first image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Backspace</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Previous Image</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Goes to the previous image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Space</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Next Image</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Goes to the next image</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>End</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Last Image</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Goes to the last image</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Image Back</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Each image you view is appended to a chain. You may traverse forwards and backwards through this chain using this and the following key. Move to the previous image in the chain.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Image Forward</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Move to the next image in the chain.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Back</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Back Goes to the previous folder</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Home</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Home</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Goes to the the Home folder as defined in
+ <link linkend="GuideOptionsLayout" endterm="titleGuideOptionsLayout" />
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>Home</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>First Page</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Goes to the first page.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>End</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Last Page</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Goes to the last page.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>PageUp</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Previous Page</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Goes to the previous page.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>PageDown</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Next Page</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Goes to the next page.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Selectmenu">
+ <title>Select menu</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>A</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Select all</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Selects all files in the current list</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>Shift</keycap>
+ <keycap>A</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Select none</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Deselects all files</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>Shift</keycap>
+ <keycap>I</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Invert selection</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Inverts current selection</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Alt</keycap>
+ <keycap>R</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Rectangular selection</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Toggles rectangular selection mode for icons</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Copy path</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Copy selected item-path(s) to clipboard
+ <footnote id='ref1'>
+ The clipboard used is selected
+ <link linkend="Behaviour">here.</link>
+ </footnote>
+ . Each data item copied will be enclosed in quotes.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Copy path unquoted</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Copy selected item-path(s) to clipboard. The data will not be enclosed in quotes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>M</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Show marks</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Displays marks in the file list</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Clear marks</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Clear all marks for all images</para>
+ <warning>
+ <para>Marks that are linked to keywords will also be cleared. This may result in a metadata write operation being triggered.</para>
+ </warning>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Mark n</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens submenu for manipulating mark n</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>n</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Mark n</guimenu>
+ <guimenuitem>Toggle Mark n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Set or unset mark n on selected files</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Mark n</guimenu>
+ <guimenuitem>Set mark n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Set mark n on selected files</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Mark n</guimenu>
+ <guimenuitem>Reset mark n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Unset mark n on selected files</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>n</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Mark n</guimenu>
+ <guimenuitem>Select mark n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Selects all files having mark n set</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Mark n</guimenu>
+ <guimenuitem>Add mark n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Adds files having mark n set to selection</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Mark n</guimenu>
+ <guimenuitem>Intersection with mark n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Intersects current selection and mark n</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Mark n</guimenu>
+ <guimenuitem>Unselect mark n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Removes files having mark n set from current selection</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Mark n</guimenu>
+ <guimenuitem>Filter mark n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Shows only the images that have mark n set.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Editmenu">
+ <title>Edit menu</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Orientation</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Adjust image orientation</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>]</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Rotate clockwise</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Rotates the current image clockwise 90 degrees, does not modify the file on disk.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>[</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Rotate counterclockwise</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>R</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Rotate 180</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Rotates the current image 180 degrees, does not modify the file on disk.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>M</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Mirror</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Swaps the left and right sides of the image so that the result is similar to that of looking at the image in a mirror, does not modify the file on disk.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>F</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Flip</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Swaps the top and bottom sides of the image, does not modify the file on disk.</para>
+ <warning>
+ <para>
+ The above orientation commands - Rotate, Mirror and Flip - do not change the image on disk. The changes will be lost when Geeqie closes. Refer to the
+ <link linkend="MetadataMiscellaneous">Metadata tab of the Preferences Dialog</link>
+ if you wish these changes to be written to metadata.
+ </para>
+ <para>
+ Refer also to the
+ <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>
+ .
+ </para>
+ </warning>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>O</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Original state</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Removes all temporary effects applied through the above commands, reverting the image according to its Exif Orientation tag.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Auto rotate image using EXIF information</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Auto rotates images based on metadata stored in images that have Exif data. Refer also to the
+ <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>
+ .
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Apply the orientation to image content</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>This command affects only jpeg, tiff and png files. The image file on disk is rotated to the orientation as specified by its Exif Orientation tag.</para>
+ <warning>
+ <para>
+ The file rotate.desktop, using external commands exiftran, exiv2 and mogrify, is used to implement this command. Refer to
+ <link linkend="GuideImageManagementPlugins">Plugins section</link>
+ for details.
+ </para>
+ </warning>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>[</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Rotate counterclockwise</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>R</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Rotate 180</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Rotates the current image 180 degrees, does not modify the file on disk.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Write orientation to file</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Saves the current image orientation to the disk file. This operation can only be carried out on jpeg, tiff and png files. Jpeg rotations are lossless.
+ <note>
+ The Preferences/Metadata option "Write altered image orientation to the metadata" must be off.
+ <para />
+ Exiftran and mogrify must be installed.
+ </note>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Orientation</guimenu>
+ <guimenuitem>Write orientation to file (preserve timestamp)</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>As above, but the file date and time are preserved.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Rating</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Set a Rating value for each image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Alt+Keypad+n</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Rating</guimenu>
+ <guimenuitem>n</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>"n" is in the range 0 to 5. Sets the Rating value for the image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Alt+Keypad+Minus</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Rating</guimenu>
+ <guimenuitem>-1</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Sets the Rating value to -1 for the image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>S</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Save metadata</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Saves queued metadata changes. Autosave can be configured too.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>O</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Preferences</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Opens the
+ <link linkend="GuideOptions">Preferences Dialog</link>
+ for changing of global preferences.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Configure Plugins…</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Opens the
+ <link linkend="GuideImageManagementPlugins">Plugins Dialog</link>
+ for changing of desktop files.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Configure This window…</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Opens the
+ <link linkend="GuideOptionsWindow">Window Preferences Dialog</link>
+ for changing of options that can differ for each window.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Cache maintenance</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Opens a dialog with utilities for thumbnail and keyword
+ <link linkend="GuideReferenceManagement" endterm="titleGuideReferenceManagement" />
+ .
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Set as wallpaper</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Renders the current image to the root window (desktop). The resulting image will be tiled to fit the root window if zoom is not set to
+ <emphasis role="i">Fit to window</emphasis>
+ ; when zoom is set to
+ <emphasis role="i">Fit to window</emphasis>
+ , the image will be scaled to fill the root window.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Pluginsmenu">
+ <title>Plugins menu</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Plugins</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ This menu contains the plugins (desktop files) that were found on the system. See the
+ <link linkend="GuideImageManagementPlugins">Plugins section</link>
+ for details.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Viewmenu">
+ <title>View menu</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>V</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>View in new window</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens selected image in its own window</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>J</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Pan view</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens current folder in Pan view window</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>E</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Exif data</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Toggles display of the Exif sidebar.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Meta</keycap>
+ <keycap>L</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Files and Folders</guimenu>
+ <guimenu>Folder List</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Set the folder view mode to list.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>T</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Files and Folders</guimenu>
+ <guimenuitem>Folder Tree</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Set the folder view mode to tree.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>L</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Files and Folders</guimenu>
+ <guimenuitem>Image List</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Changes the file list to display files in list format.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>I</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Files and Folders</guimenu>
+ <guimenuitem>Icons</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Changes the file list to display files as icons.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Files and Folders</guimenu>
+ <guimenuitem>Show Thumbnails</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Toggles the display of image thumbnails in the file list, this item is not available when the file list is in icon view mode. A check appears next to this item when thumbnails are enabled.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>L</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Files and Folders</guimenu>
+ <guimenuitem>Float file list</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Splits the 3-pane main window into two parts:
+ <itemizedlist>
+ <listitem>File pane and Folder pane, along with menu and status bar</listitem>
+ <listitem>Image pane and its associated sidebar and sort manager (if displayed)</listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>H</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Files and Folders</guimenu>
+ <guimenuitem>Hide file list</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Hides the File and Folder panes, along with menu and status bar.
+ <code>Right-click</code>
+ on the Image pane provides a menu item to redisplay these items.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Files and Folders</guimenu>
+ <guimenuitem>Hide toolbar</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Toggles visibility of the tool bar. A check appears next to this item when the tool bar is not visible.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Zoom</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para />
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Zoom</guimenu>
+ <guimenuitem>Connected zoom</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Actions in this menu are identical to those in
+ <emphasis role="bold">Zoom</emphasis>
+ menu, but apply to all images displayed in split view.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Zoom</guimenu>
+ <guimenuitem>Zoom in</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Increases the zoom by one increment, resulting in a larger image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Zoom</guimenu>
+ <guimenuitem>Zoom out</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Decreases the zoom by one increment, resulting in a smaller image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Zoom</guimenu>
+ <guimenuitem>Zoom to fit</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Automatically adjusts the zoom so that the image will fit within the display pane. The effect on images with an original size smaller than the display pane can be changed with the
+ <emphasis>Allow enlargement of image for zoom to fit</emphasis>
+ option located on the
+ <link linkend="GuideOptionsImage">Image tab</link>
+ of the preferences dialog.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Zoom</guimenu>
+ <guimenuitem>Fit Horizontally</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Adjusts the zoom so image height fit within the display pane.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Zoom</guimenu>
+ <guimenuitem>Fit Vertically</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Adjusts the zoom so image width fit within the display pane.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="document-new.png" />
+ </guiicon>
+ New
+ </guibutton>
+ </code>
+ <shortcut>
+ <keycombo>
+ <keycap>Z</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Zoom</guimenu>
+ <guimenuitem>Zoom n:m</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Set zoom to the n:m value. 1:1 is the original size of the image. When n is greater than m, zoom in occurs else zoom out occurs.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Z</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Zoom</guimenu>
+ <guimenuitem>Zoom n:m</guimenuitem>
+ </menuchoice>
+ <guimenu>Split</guimenu>
+ </term>
+ <listitem>
+ <para />
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Split</guimenu>
+ <guimenuitem>Horizontal</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Splits main image view in two horizontal panes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>U</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Split</guimenu>
+ <guimenuitem>Vertical</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Splits main image view in two vertical panes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Split</guimenu>
+ <guimenuitem>Quad</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Splits main image view in four panes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Y</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Split</guimenu>
+ <guimenuitem>Single</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Reverts to normal view mode (one image).</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist />
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Image Overlay</guimenu>
+ <guimenu>Image Overlay</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Displays Image Overlay information box (OSD), use twice to add histogram to it.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Image Overlay</guimenu>
+ <guimenu>Histogram channels</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Switches channels displayed in the histogram (red, green, blue, RGB, value, maximum value).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Image Overlay</guimenu>
+ <guimenu>Histogram log mode</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Toggles between linear and logarithmical histogram.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Full screen</guimenu>
+ </term>
+ <listitem>
+ <para>Toggles the full screen window display.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>E</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Over/Under Exposure</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Toggles highlighting of pixels that are either over or under exposed. This function operates on the displayed pixels. If a raw file is being displayed, the embedded jpeg data is being used. If the image is zoomed, the zoom type affects the results. Two-pass rendering also has some influence.
+ <para />
+ If a pixel has any channel at zero or full-scale, the pixel is displayed in red.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Keywords</guimenu>
+ </term>
+ <listitem>
+ <para>Toggles display of the Keywords sidebar.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Sort manager</guimenu>
+ </term>
+ <listitem>
+ <para>Toggles display of the Sort Manager sidebar.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Hide Bars</guimenu>
+ </term>
+ <listitem>
+ <para>This item is intended to be used by its shortcut key - by default this is the backtick key. When pressed, the info sidebar, sort manager and file list will be hidden (if displayed). Pressing backtick again will revert the display to its previous layout.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Toggle slideshow</guimenu>
+ </term>
+ <listitem>
+ <para>Begins or ends a slide show, the slide show status is displayed in the status bar.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Pause slideshow</guimenu>
+ </term>
+ <listitem>
+ <para>Pauses a slide show, the slide show status is displayed in the status bar.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Faster</guimenu>
+ </term>
+ <listitem>
+ <para>Decreases slide show interval in units of 0.5 seconds.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Slower</guimenu>
+ </term>
+ <listitem>
+ <para>Increases slide show interval in units of 0.5 seconds.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guimenu>Refresh</guimenu>
+ </term>
+ <listitem>
+ <para>Updates the contents of the folder and file lists to match what is currently on disk, the current image will also be reread from disk.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Windowmenu">
+ <title>Windows menu</title>
+ <para>This menu permits you to define several different window layouts that can be recalled at any time.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>N</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>New window</guimenu>
+ <guimenuitem>default</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a new window with the default layout. The window is given a name in the form "lw<n>".</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>New window</guimenu>
+ <guimenuitem>from current</guimenuitem>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a new window with the layout of the window that has focus. The window is given a name in the form "lw<n>".</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Rename window</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>If a window is given a name that does not begin with the characters "lw", the layout will be saved and be available for loading at a later time..</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Delete window</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Delete a saved window layout from the list.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Close window</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Close the window. If the window is the "main" window, close all windows.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Helpmenu">
+ <title>Help menu</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>F1</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Contents</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens the Geeqie user manual in a new browser window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>/</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Search and Run Commands</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Opens a text box in which you may type characters to find a command. The characters you type will be matched to the first characters of any word in all the commands in Geeqie - both built-in commands and plugins - and matching actions will be displayed in a pop-up. You may scroll to any of the matching commands and press
+ <code>Enter</code>
+ to execute the command. Pressing
+ <code>Enter</code>
+ without selecting from the list will execute the first action in the list. Press
+ <code>Esc</code>
+ to close the box.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>On-line help search</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>
+ Use a web browser to search Geeqie's on-line help files. The search engine used is defined in
+ <link linkend="OnLineHelpSearch">Preferences General</link>
+ .
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Keyboard shortcuts</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Displays a window listing the default keyboard shortcuts.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Keyboard Map</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Displays an image showing the currently allocated keyboard shortcuts.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Release notes</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Displays a window containing the release notes for the version of Geeqie in use.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>About</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens a window containing the Geeqie version, credits, website, and email contact information.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <menuchoice>
+ <guimenu>Log window</guimenu>
+ </menuchoice>
+ </term>
+ <listitem>
+ <para>Opens the log window, mostly used for debugging purposes.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Tearoffmenus">
+ <title>Tear off menus</title>
+ <para>Menus can be permanently displayed by selecting the dotted line item at the top of each menu category. A tear off menu will behave the same as an ordinary window. To close a tear off menu, select the dotted line item at the top of the menu.</para>
+ <para />
+ </section>
+ <section id="Keyboardshortcuts">
+ <title>Keyboard shortcuts</title>
+ <para>
+ The keyboard sequence associated to each menu entry is listed within the main window menu bar. For reference, the complete list of default keyboard shortcuts can be found in section
+ <link linkend="GuideReferenceKeyboardShortcuts">Keyboard Shortcuts</link>
+ .
+ </para>
+ <para />
+ </section>
+ <section id="Changingthemainwindowmenubarkeyboardshortcuts">
+ <title>Changing the main window menu bar keyboard shortcuts</title>
+ <para>
+ The section
+ <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />
+ describes how to modify the keyboard shortcuts used in the main menu.
+ </para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideMainWindowStatusBar">\r
- <title id="titleGuideMainWindowStatusBar">Status Bar</title>\r
- <para>The status bar contains information and details about the contents of the main window. Information displayed includes the progress of generating thumbnails, the number of files in the file list with byte size, the current file selection count including byte size, details about the currently displayed image, and the zoom and image scroll settings. The current sort preference is also displayed, and can be adjusted from the status bar.</para>\r
- <para>The status bar is comprised of five sections, from left to right these are a progress bar, sort method, file list counts, image details, and zoom and scroll setting. Each section is described below.</para>\r
- <para />\r
- <section id="ProgressBar">\r
- <title>Progress Bar</title>\r
- <para>\r
- The Progress bar updates to display the current state of thumbnail generation, or the reading of metadata in the current folder.\r
- <para />\r
- When “Loading thumbs...” is displayed, thumbnails are currently being generated when Geeqie is idle; the progress bar will update to display the percentage of thumbnails that are completed.\r
- <para />\r
- When “Loading meta...” is displayed, certain metadata is being loaded when Geeqie is idle; the progress bar will update to display the percentage of files that have been read. Refer to\r
- <link linkend="PreLoadMetadata">Preferences metadata.</link>\r
- </para>\r
- </section>\r
- <section id="Sortmethod">\r
- <title>Sort method</title>\r
- <para>This is the method used to sort image names in the file list. Clicking or activating this field will display a menu to allow selection of the sort method.</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Name</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Images are sorted by file name.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Number</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Images are sorted by natural numerical order, such that, for example, 9_name.jpg will be listed before 10_name.jpg.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Date</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Images are sorted by file modification date.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>File Date</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Images are sorted by one of four types of file date. They are described in the\r
- <link linkend="GuideReferenceFileDates">Reference section</link>\r
- .\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Images are sorted by file size on disk.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Rating</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Image are sorted by Xmp.xmp.Rating.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Class</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Image are sorted by class. The class types, and sort order, is:</para>\r
- <itemizedlist>\r
- <listitem>Unknown</listitem>\r
- <listitem>Image</listitem>\r
- <listitem>Raw Image</listitem>\r
- <listitem>Video</listitem>\r
- <listitem>Metadata</listitem>\r
- </itemizedlist>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Ascending</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Toggles between increasing and decreasing sort order. A check will appear next to this entry to indicate ascending sort order.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <note>When images have equal rank, for example in rating or class sorts, within each section images will be sorted by filename.</note>\r
- </section>\r
- <section id="Filelist">\r
- <title>File list</title>\r
- <para>This section displays the count of files that appear in the file list, including the total byte size. The number of files selected is displayed in parenthesis, including the total byte size of the selected files. The slide show status is also displayed here; when a slide show is running, “Slideshow” will appear, the text will change to “Paused” when a slide show is in the paused state.</para>\r
- <para />\r
- </section>\r
- <section id="ImageDetails">\r
- <title>Image Details</title>\r
- <para>This section displays the dimensions (width x height) and file byte size of the image that is active in the image pane. When the format of the file in the image pane can not be determined the dimensions will show as “(0 x 0)”, in addition “(no read permission)” may appear if the file permissions do not allow reading the contents of the file.</para>\r
- <para />\r
- </section>\r
- <section id="ZoomAndScroll">\r
- <title>Zoom and Scroll</title>\r
- <para>The button label displays the current zoom ratio. A ratio of 1:1 is the image's original size. When the left number is larger the image is displayed larger than original size, when the right number is larger the image is displayed smaller.</para>\r
- <para>A tilde (~) appears within the ratio display when the zoom is set to fit the image within the display area. In this zoom mode the ratio is automatically adjusted, and the displayed ratio may not be the actual ratio because the status bar display rounds the actual value to the nearest tenth (0.1).</para>\r
- <para />\r
- <para>Clicking this button permits control of the behavior of the zoom and scroll settings used when changing the displayed image.</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Zoom to original size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The new image is set to its original size.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Fit image to window</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The new image's zoom is changed so that the image will fit within the current view area.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Leave zoom at previous setting</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The zoom setting is unchanged, the new image will be scaled the same as the previous image.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Scroll to top left corner</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The new image is displayed from top left corner.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Scroll to image center</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The new image is centered</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Keep the region from previous image</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The new image is positioned as the previous one, whenever possible.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Buttons">\r
- <title>Buttons</title>\r
- <para>\r
- The Status bar toolbar buttons, the defaults are shown below, correspond to selected menu action. The buttons displayed may be changed in the\r
- <link linkend="GuideOptionsToolbar">Toolbar tab of Preferences.</link>\r
- </para>\r
- <para />\r
- <section id="ExifRotate">\r
- <title>Exif rotate</title>\r
- <para>\r
- <guiicon>\r
- <inlinegraphic fileref="gtk-color-picker.png" />\r
- </guiicon>\r
- Toggles the auto-rotation of images if they have Exif orientation data.\r
- Refer also to the\r
- <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>\r
- .\r
- </para>\r
- <para />\r
- </section>\r
- <section id="ShowPixelInfo">\r
- <title>Show Pixel Info</title>\r
- <para>\r
- <guiicon>\r
- <inlinegraphic fileref="gtk-color-picker.png" />\r
- </guiicon>\r
- Shows coordinates and RGB value under cursor.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="EnableColorManagement">\r
- <title>Enable Color Management</title>\r
- <para>\r
- <guiicon>\r
- <inlinegraphic fileref="gtk-select-color.png" />\r
- </guiicon>\r
- Enables color profiles.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="SaveMetadata">\r
- <title>Save Metadata</title>\r
- <para>\r
- <guiicon>\r
- <inlinegraphic fileref="document-save.png" />\r
- </guiicon>\r
- Opens dialog for review and saving of metadata changes.\r
- </para>\r
- <para />\r
- </section>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideMainWindowStatusBar">
+ <title id="titleGuideMainWindowStatusBar">Status Bar</title>
+ <para>The status bar contains information and details about the contents of the main window. Information displayed includes the progress of generating thumbnails, the number of files in the file list with byte size, the current file selection count including byte size, details about the currently displayed image, and the zoom and image scroll settings. The current sort preference is also displayed, and can be adjusted from the status bar.</para>
+ <para>The status bar is comprised of five sections, from left to right these are a progress bar, sort method, file list counts, image details, and zoom and scroll setting. Each section is described below.</para>
+ <para />
+ <section id="ProgressBar">
+ <title>Progress Bar</title>
+ <para>
+ The Progress bar updates to display the current state of thumbnail generation, or the reading of metadata in the current folder.
+ <para />
+ When “Loading thumbs...” is displayed, thumbnails are currently being generated when Geeqie is idle; the progress bar will update to display the percentage of thumbnails that are completed.
+ <para />
+ When “Loading meta...” is displayed, certain metadata is being loaded when Geeqie is idle; the progress bar will update to display the percentage of files that have been read. Refer to
+ <link linkend="PreLoadMetadata">Preferences metadata.</link>
+ </para>
+ </section>
+ <section id="Sortmethod">
+ <title>Sort method</title>
+ <para>This is the method used to sort image names in the file list. Clicking or activating this field will display a menu to allow selection of the sort method.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Name</guilabel>
+ </term>
+ <listitem>
+ <para>Images are sorted by file name.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Number</guilabel>
+ </term>
+ <listitem>
+ <para>Images are sorted by natural numerical order, such that, for example, 9_name.jpg will be listed before 10_name.jpg.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Date</guilabel>
+ </term>
+ <listitem>
+ <para>Images are sorted by file modification date.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>File Date</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Images are sorted by one of four types of file date. They are described in the
+ <link linkend="GuideReferenceFileDates">Reference section</link>
+ .
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Size</guilabel>
+ </term>
+ <listitem>
+ <para>Images are sorted by file size on disk.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Rating</guilabel>
+ </term>
+ <listitem>
+ <para>Image are sorted by Xmp.xmp.Rating.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Class</guilabel>
+ </term>
+ <listitem>
+ <para>Image are sorted by class. The class types, and sort order, is:</para>
+ <itemizedlist>
+ <listitem>Unknown</listitem>
+ <listitem>Image</listitem>
+ <listitem>Raw Image</listitem>
+ <listitem>Video</listitem>
+ <listitem>Metadata</listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Ascending</guilabel>
+ </term>
+ <listitem>
+ <para>Toggles between increasing and decreasing sort order. A check will appear next to this entry to indicate ascending sort order.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <note>When images have equal rank, for example in rating or class sorts, within each section images will be sorted by filename.</note>
+ </section>
+ <section id="Filelist">
+ <title>File list</title>
+ <para>This section displays the count of files that appear in the file list, including the total byte size. The number of files selected is displayed in parenthesis, including the total byte size of the selected files. The slide show status is also displayed here; when a slide show is running, “Slideshow” will appear, the text will change to “Paused” when a slide show is in the paused state.</para>
+ <para />
+ </section>
+ <section id="ImageDetails">
+ <title>Image Details</title>
+ <para>This section displays the dimensions (width x height) and file byte size of the image that is active in the image pane. When the format of the file in the image pane can not be determined the dimensions will show as “(0 x 0)”, in addition “(no read permission)” may appear if the file permissions do not allow reading the contents of the file.</para>
+ <para />
+ </section>
+ <section id="ZoomAndScroll">
+ <title>Zoom and Scroll</title>
+ <para>The button label displays the current zoom ratio. A ratio of 1:1 is the image's original size. When the left number is larger the image is displayed larger than original size, when the right number is larger the image is displayed smaller.</para>
+ <para>A tilde (~) appears within the ratio display when the zoom is set to fit the image within the display area. In this zoom mode the ratio is automatically adjusted, and the displayed ratio may not be the actual ratio because the status bar display rounds the actual value to the nearest tenth (0.1).</para>
+ <para />
+ <para>Clicking this button permits control of the behavior of the zoom and scroll settings used when changing the displayed image.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Zoom to original size</guilabel>
+ </term>
+ <listitem>
+ <para>The new image is set to its original size.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Fit image to window</guilabel>
+ </term>
+ <listitem>
+ <para>The new image's zoom is changed so that the image will fit within the current view area.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Leave zoom at previous setting</guilabel>
+ </term>
+ <listitem>
+ <para>The zoom setting is unchanged, the new image will be scaled the same as the previous image.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Scroll to top left corner</guilabel>
+ </term>
+ <listitem>
+ <para>The new image is displayed from top left corner.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Scroll to image center</guilabel>
+ </term>
+ <listitem>
+ <para>The new image is centered</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Keep the region from previous image</guilabel>
+ </term>
+ <listitem>
+ <para>The new image is positioned as the previous one, whenever possible.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Buttons">
+ <title>Buttons</title>
+ <para>
+ The Status bar toolbar buttons, the defaults are shown below, correspond to selected menu action. The buttons displayed may be changed in the
+ <link linkend="GuideOptionsToolbar">Toolbar tab of Preferences.</link>
+ </para>
+ <para />
+ <section id="ExifRotate">
+ <title>Exif rotate</title>
+ <para>
+ <guiicon>
+ <inlinegraphic fileref="gtk-color-picker.png" />
+ </guiicon>
+ Toggles the auto-rotation of images if they have Exif orientation data.
+ Refer also to the
+ <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>
+ .
+ </para>
+ <para />
+ </section>
+ <section id="ShowPixelInfo">
+ <title>Show Pixel Info</title>
+ <para>
+ <guiicon>
+ <inlinegraphic fileref="gtk-color-picker.png" />
+ </guiicon>
+ Shows coordinates and RGB value under cursor.
+ </para>
+ <para />
+ </section>
+ <section id="EnableColorManagement">
+ <title>Enable Color Management</title>
+ <para>
+ <guiicon>
+ <inlinegraphic fileref="gtk-select-color.png" />
+ </guiicon>
+ Enables color profiles.
+ </para>
+ <para />
+ </section>
+ <section id="SaveMetadata">
+ <title>Save Metadata</title>
+ <para>
+ <guiicon>
+ <inlinegraphic fileref="document-save.png" />
+ </guiicon>
+ Opens dialog for review and saving of metadata changes.
+ </para>
+ <para />
+ </section>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideOptionsAdditional">\r
- <title id="titleGuideOptionsAdditional">Additional Preferences</title>\r
- <para>There are two sets of preferences in Geeqie: those set via the main Preferences tabbed dialogue, and those set either via a menu entry or by editing a configuration file.</para>\r
-\r
- <para>\r
- This chapter explains in detail the Geeqie preferences that are set via a menu entry or by editing a configuration file.\r
- </para>\r
-\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsLayout.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuidePluginsConfig.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsHidden.xml" />\r
- <para />\r
-\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideOptionsAdditional">
+ <title id="titleGuideOptionsAdditional">Additional Preferences</title>
+ <para>There are two sets of preferences in Geeqie: those set via the main Preferences tabbed dialogue, and those set either via a menu entry or by editing a configuration file.</para>
+
+ <para>
+ This chapter explains in detail the Geeqie preferences that are set via a menu entry or by editing a configuration file.
+ </para>
+
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsLayout.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuidePluginsConfig.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsHidden.xml" />
+ <para />
+
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
- <section id="GuideOptionsAdvanced">\r
-<title>Advanced</title>\r
- <section id="ExternalPreviewExtraction">\r
- <title>External preview extraction</title>\r
- <para>\r
- The intention of this feature is to give the user the possibility to display image previews of files\r
- that the standard libraries cannot decode.\r
- <para />\r
- An example is the .dng files produced by LG V30 cameras. Neither\r
- <code>exiv2</code>\r
- nor\r
- <code>libraw</code>\r
- can\r
- extract a preview, but the command line program\r
- <code>dcraw</code>\r
- can.\r
- <para />\r
- This feature allows a work-around until the standard libraries provide a solution.\r
- <para />\r
- Two command files are required: one to identify which files to process, and one to extract or decode the preview image.\r
- <para />\r
- The format for the identification tool is:\r
- <para />\r
- <pre>\r
- <programlisting xml:space="preserve">\r
- Parameter 1: (input) full path name to the current image.\r
- <para />\r
- Returns: 0 for file match, any other value for no match.\r
- </programlisting>\r
- </pre>\r
- <para />\r
- The format for the extraction tool is:\r
- <para />\r
- <pre>\r
- <programlisting xml:space="preserve">\r
- Parameter 1: (input) full path name to the current image.\r
- <para />\r
- Parameter 2: (output) a temporary file name generated by Geeqie. The tool should load this file with the decoded image.\r
- <para />\r
- Returns: not used.\r
- </programlisting>\r
- </pre>\r
- <para />\r
- This is an example of an identification tool using a shell script:\r
- <para />\r
- <pre>\r
- <programlisting xml:space="preserve">#! /bin/bash\r
-\r
- filename=$(basename -- "$1")\r
- extension="${filename##*.}"\r
-\r
- shopt -s nocasematch\r
- if [[ $extension == "DNG" ]]\r
- then\r
- cameramodel=$(exiv2 -K Exif.Image.UniqueCameraModel -Pt "$1" )\r
- if [[ $cameramodel == "LG-H930" ]]\r
- then\r
- exit 0\r
- else\r
- exit 1\r
- fi\r
- else\r
- exit 1\r
- fi</programlisting>\r
- </pre>\r
- </para>\r
- <para>\r
- This is an example of an extraction/decode tool using a shell script:\r
- <pre>\r
- <programlisting xml:space="preserve">#! /bin/bash\r
- dcraw -e -c "$1" > "$2"</programlisting>\r
- </pre>\r
- <para />\r
- Alternatively:\r
- <pre>\r
- <programlisting xml:space="preserve">#! /bin/bash\r
- gm convert "$1" "$2"</programlisting>\r
- </pre>\r
- </para>\r
- <para>\r
- If the decode tool requires an output file with a particular extension, use this method:\r
- <pre>\r
- <programlisting xml:space="preserve">#! /bin/bash\r
- tmpfile=$(mktemp --tmpdir=$tempdir geeqie_tmp_XXXXXX.jpg)\r
- gm convert "$1" $tmpfile\r
- mv $tmpfile "$2"</programlisting>\r
- </pre>\r
- </para>\r
-</section>\r
-<section id="ThreadPools">\r
- <title>Thread Pools</title>\r
- <para>This option will limit the number of threads (cores) that are used when performing a duplicate image search. A value of <code>0</code> means use all available threads. This will give the fastest processing time, but will slow other processes including user input response time.</para> \r
-</section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+ <section id="GuideOptionsAdvanced">
+<title>Advanced</title>
+ <section id="ExternalPreviewExtraction">
+ <title>External preview extraction</title>
+ <para>
+ The intention of this feature is to give the user the possibility to display image previews of files
+ that the standard libraries cannot decode.
+ <para />
+ An example is the .dng files produced by LG V30 cameras. Neither
+ <code>exiv2</code>
+ nor
+ <code>libraw</code>
+ can
+ extract a preview, but the command line program
+ <code>dcraw</code>
+ can.
+ <para />
+ This feature allows a work-around until the standard libraries provide a solution.
+ <para />
+ Two command files are required: one to identify which files to process, and one to extract or decode the preview image.
+ <para />
+ The format for the identification tool is:
+ <para />
+ <pre>
+ <programlisting xml:space="preserve">
+ Parameter 1: (input) full path name to the current image.
+ <para />
+ Returns: 0 for file match, any other value for no match.
+ </programlisting>
+ </pre>
+ <para />
+ The format for the extraction tool is:
+ <para />
+ <pre>
+ <programlisting xml:space="preserve">
+ Parameter 1: (input) full path name to the current image.
+ <para />
+ Parameter 2: (output) a temporary file name generated by Geeqie. The tool should load this file with the decoded image.
+ <para />
+ Returns: not used.
+ </programlisting>
+ </pre>
+ <para />
+ This is an example of an identification tool using a shell script:
+ <para />
+ <pre>
+ <programlisting xml:space="preserve">#! /bin/bash
+
+ filename=$(basename -- "$1")
+ extension="${filename##*.}"
+
+ shopt -s nocasematch
+ if [[ $extension == "DNG" ]]
+ then
+ cameramodel=$(exiv2 -K Exif.Image.UniqueCameraModel -Pt "$1" )
+ if [[ $cameramodel == "LG-H930" ]]
+ then
+ exit 0
+ else
+ exit 1
+ fi
+ else
+ exit 1
+ fi</programlisting>
+ </pre>
+ </para>
+ <para>
+ This is an example of an extraction/decode tool using a shell script:
+ <pre>
+ <programlisting xml:space="preserve">#! /bin/bash
+ dcraw -e -c "$1" > "$2"</programlisting>
+ </pre>
+ <para />
+ Alternatively:
+ <pre>
+ <programlisting xml:space="preserve">#! /bin/bash
+ gm convert "$1" "$2"</programlisting>
+ </pre>
+ </para>
+ <para>
+ If the decode tool requires an output file with a particular extension, use this method:
+ <pre>
+ <programlisting xml:space="preserve">#! /bin/bash
+ tmpfile=$(mktemp --tmpdir=$tempdir geeqie_tmp_XXXXXX.jpg)
+ gm convert "$1" $tmpfile
+ mv $tmpfile "$2"</programlisting>
+ </pre>
+ </para>
+</section>
+<section id="ThreadPools">
+ <title>Thread Pools</title>
+ <para>This option will limit the number of threads (cores) that are used when performing a duplicate image search. A value of <code>0</code> means use all available threads. This will give the fastest processing time, but will slow other processes including user input response time.</para>
+</section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsBehavior">\r
- <title>Behavior Options</title>\r
- <para>This section describes the options presented under the Behavior Tab of the preferences dialog.</para>\r
- <section id="Delete">\r
- <title>Delete</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Confirm permanent file delete</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Prompts for confirmation before deleting files.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Confirm move file to Trash</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Prompts for confirmation before moving files to the trash bin.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>\r
- Enable\r
- <keycap>Delete key</keycap>\r
- </guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Disable this to disassociate the delete file function from the\r
- <keycap>Delete</keycap>\r
- key.\r
- </para>\r
- <para>\r
- If\r
- <emphasis>Confirm file delete</emphasis>\r
- , above, is disabled, accidentally hitting the\r
- <keycap>Delete</keycap>\r
- can result in files being erroneously deleted without warning. Disabling the\r
- <keycap>Delete</keycap>\r
- key will prevent this. The\r
- <code>\r
- Ctrl +\r
- <keycap>D</keycap>\r
- </code>\r
- key sequence is not affected.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use Geeqie trash location</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Moves deleted files to a temporary folder, for easy retrieval of deleted files. Files in the temporary folder are retained until the maximum size is reached, at which point deleting additional files will result in the removal of the oldest files to reclaim the space needed for the new files.</para>\r
- <note>\r
- <para>\r
- Files moved to the Safe Delete folder are prefixed with a six digit number in the format:\r
- <literal>nnnnnn_FILENAME</literal>\r
- <para />\r
- This is used by the delete feature to distinguish which files to remove first when clearing space for new files.\r
- <para />\r
- The digit counter increments with each deleted file.\r
- </para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use system Trash bin</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Moves deleted files to the system-defined trash bin.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Folder</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The location of the folder used by the Safe Delete feature.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Maximum size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The size to use for the Safe Delete folder, in megabytes. Note that setting this value to 0 (zero) will disable any limit.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Clear button</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Removes all files contained in the Safe Delete folder.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>View button</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Changes the Geeqie main window to display the contents of the Safe Delete folder.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Behaviour">\r
- <title>Behavior</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Descend folders in tree view</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.</para>\r
- <note>\r
- <para>Disable this if Geeqie wakes up auto mounted network shares, or takes too long to initially display the folder view.</para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>In place renaming</guilabel>\r
- </term>\r
- <listitem>\r
- <para>When renaming a single file, this will allow the rename entry to appear directly over the original filename.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>List directory view uses single click to enter</guilabel>\r
- </term>\r
- <listitem>\r
- <para>If selected, a single click will enter a directory, rather than the GTK+ default of a double click.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Circular selection lists</guilabel>\r
- </term>\r
- <listitem>\r
- <para>If selected, when traversing a list of selected images using Next or Previous Image, when the last or first image is encountered the focus moves to the beginning or end of the list. When deselected, focus will go no further than the start or end of the list.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Save marks on exit</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Save all marks that have been set. Note that marks that are linked to a keyword will always be saved irrespective of this setting.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use "With Rename" as default for Copy/Move dialogs</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Move the "With Rename" button to the default position.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Open Collections on top</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Open collection windows with "Always on Top" set.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Recent folder list maximum size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This is the number of entries to be saved from the recent open folder list drop-down box. The number of entries displayed in the current session is unlimited.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Drag'n drop icon size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This is the width and height of the icon generated from image and displayed when doing drag and drop actions. High resolution screens may require to increase this number.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Drag'n drop default action</guilabel>\r
- </term>\r
- <listitem>\r
- <para>When using drag and drop to copy or move files, the default action is to use a pop-up menu to permit you to select which action is to be taken. This option allows you to set the default action to either Copy or Move.\r
- </para>\r
- <note>\r
- <para>When using the pop-up menu, the menu will also include an option for a symbolic link and any other plugins that are defined as being a <link linkend="Geeqieextensions">filter</link>. If you set the default action to Copy or Move these additional options will not be available to you.</para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Copy path clipboard selection</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- This option determines which clipboard selection is used for the "Copy path" menu item. The exact method of the paste operation will depend on the operating system, but in general will be:\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Primary</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Paste using mouse middle-click, or shift-insert.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Clipboard</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Paste using mouse right-click and select paste, or control-v.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Both</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Paste using either method.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Navigation">\r
- <title>Navigation</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Progressive keyboard scrolling</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Keyboard scrolling step multiplier:</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Defines the amount to pan an image when using the keyboard arrows.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Mouse wheel scrolls image</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- The default is for the mouse wheel to change the image, and to scroll the image when\r
- <keycap>Shift</keycap>\r
- is used in combination with the wheel. Enabling this swaps the behavior so that operating the wheel will scroll the image, and holding down\r
- <keycap>Shift</keycap>\r
- will change the image.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Navigation by left or middle click on image</guilabel>\r
- </term>\r
- <listitem>\r
- <para>If selected, mouse left-click will select the next image; mouse middle-click will select the previous image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Open archive by left click on image</guilabel>\r
- </term>\r
- <listitem>\r
- <para>If selected, mouse left-click on an image belonging to the archive class will decompress the file contents and display them in a new Geeqie window.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Play video by left click on image</guilabel>\r
- </term>\r
- <listitem>\r
- <para>If selected, mouse left-click on an image belonging to the video class will start a program chosen in a box below.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Mouse button Back/Forward</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Some mice have additional buttons designated Back/Forward (mouse buttons 8 and 9). You may allocate any menu item to either of these buttons.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Debugging">\r
- <title>Debugging</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Debug level</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Displayed when compiled with the option --enable-debug-log. This defines the verbosity of debug info sent to console and log window (0 disables the debug output).</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Log Window max. lines</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The maximum number of data lines to be displayed. The window will show the most recent data.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsBehavior">
+ <title>Behavior Options</title>
+ <para>This section describes the options presented under the Behavior Tab of the preferences dialog.</para>
+ <section id="Delete">
+ <title>Delete</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Confirm permanent file delete</guilabel>
+ </term>
+ <listitem>
+ <para>Prompts for confirmation before deleting files.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Confirm move file to Trash</guilabel>
+ </term>
+ <listitem>
+ <para>Prompts for confirmation before moving files to the trash bin.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>
+ Enable
+ <keycap>Delete key</keycap>
+ </guilabel>
+ </term>
+ <listitem>
+ <para>
+ Disable this to disassociate the delete file function from the
+ <keycap>Delete</keycap>
+ key.
+ </para>
+ <para>
+ If
+ <emphasis>Confirm file delete</emphasis>
+ , above, is disabled, accidentally hitting the
+ <keycap>Delete</keycap>
+ can result in files being erroneously deleted without warning. Disabling the
+ <keycap>Delete</keycap>
+ key will prevent this. The
+ <code>
+ Ctrl +
+ <keycap>D</keycap>
+ </code>
+ key sequence is not affected.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Use Geeqie trash location</guilabel>
+ </term>
+ <listitem>
+ <para>Moves deleted files to a temporary folder, for easy retrieval of deleted files. Files in the temporary folder are retained until the maximum size is reached, at which point deleting additional files will result in the removal of the oldest files to reclaim the space needed for the new files.</para>
+ <note>
+ <para>
+ Files moved to the Safe Delete folder are prefixed with a six digit number in the format:
+ <literal>nnnnnn_FILENAME</literal>
+ <para />
+ This is used by the delete feature to distinguish which files to remove first when clearing space for new files.
+ <para />
+ The digit counter increments with each deleted file.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Use system Trash bin</guilabel>
+ </term>
+ <listitem>
+ <para>Moves deleted files to the system-defined trash bin.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Folder</guilabel>
+ </term>
+ <listitem>
+ <para>The location of the folder used by the Safe Delete feature.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Maximum size</guilabel>
+ </term>
+ <listitem>
+ <para>The size to use for the Safe Delete folder, in megabytes. Note that setting this value to 0 (zero) will disable any limit.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Clear button</guilabel>
+ </term>
+ <listitem>
+ <para>Removes all files contained in the Safe Delete folder.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>View button</guilabel>
+ </term>
+ <listitem>
+ <para>Changes the Geeqie main window to display the contents of the Safe Delete folder.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Behaviour">
+ <title>Behavior</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Descend folders in tree view</guilabel>
+ </term>
+ <listitem>
+ <para>This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.</para>
+ <note>
+ <para>Disable this if Geeqie wakes up auto mounted network shares, or takes too long to initially display the folder view.</para>
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>In place renaming</guilabel>
+ </term>
+ <listitem>
+ <para>When renaming a single file, this will allow the rename entry to appear directly over the original filename.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>List directory view uses single click to enter</guilabel>
+ </term>
+ <listitem>
+ <para>If selected, a single click will enter a directory, rather than the GTK+ default of a double click.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Circular selection lists</guilabel>
+ </term>
+ <listitem>
+ <para>If selected, when traversing a list of selected images using Next or Previous Image, when the last or first image is encountered the focus moves to the beginning or end of the list. When deselected, focus will go no further than the start or end of the list.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Save marks on exit</guilabel>
+ </term>
+ <listitem>
+ <para>Save all marks that have been set. Note that marks that are linked to a keyword will always be saved irrespective of this setting.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Use "With Rename" as default for Copy/Move dialogs</guilabel>
+ </term>
+ <listitem>
+ <para>Move the "With Rename" button to the default position.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Open Collections on top</guilabel>
+ </term>
+ <listitem>
+ <para>Open collection windows with "Always on Top" set.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Recent folder list maximum size</guilabel>
+ </term>
+ <listitem>
+ <para>This is the number of entries to be saved from the recent open folder list drop-down box. The number of entries displayed in the current session is unlimited.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Drag'n drop icon size</guilabel>
+ </term>
+ <listitem>
+ <para>This is the width and height of the icon generated from image and displayed when doing drag and drop actions. High resolution screens may require to increase this number.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Drag'n drop default action</guilabel>
+ </term>
+ <listitem>
+ <para>When using drag and drop to copy or move files, the default action is to use a pop-up menu to permit you to select which action is to be taken. This option allows you to set the default action to either Copy or Move.
+ </para>
+ <note>
+ <para>When using the pop-up menu, the menu will also include an option for a symbolic link and any other plugins that are defined as being a <link linkend="Geeqieextensions">filter</link>. If you set the default action to Copy or Move these additional options will not be available to you.</para>
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Copy path clipboard selection</guilabel>
+ </term>
+ <listitem>
+ <para>
+ This option determines which clipboard selection is used for the "Copy path" menu item. The exact method of the paste operation will depend on the operating system, but in general will be:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Primary</guilabel>
+ </term>
+ <listitem>
+ <para>Paste using mouse middle-click, or shift-insert.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Clipboard</guilabel>
+ </term>
+ <listitem>
+ <para>Paste using mouse right-click and select paste, or control-v.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Both</guilabel>
+ </term>
+ <listitem>
+ <para>Paste using either method.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Navigation">
+ <title>Navigation</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Progressive keyboard scrolling</guilabel>
+ </term>
+ <listitem>
+ <para>This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Keyboard scrolling step multiplier:</guilabel>
+ </term>
+ <listitem>
+ <para>Defines the amount to pan an image when using the keyboard arrows.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Mouse wheel scrolls image</guilabel>
+ </term>
+ <listitem>
+ <para>
+ The default is for the mouse wheel to change the image, and to scroll the image when
+ <keycap>Shift</keycap>
+ is used in combination with the wheel. Enabling this swaps the behavior so that operating the wheel will scroll the image, and holding down
+ <keycap>Shift</keycap>
+ will change the image.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Navigation by left or middle click on image</guilabel>
+ </term>
+ <listitem>
+ <para>If selected, mouse left-click will select the next image; mouse middle-click will select the previous image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Open archive by left click on image</guilabel>
+ </term>
+ <listitem>
+ <para>If selected, mouse left-click on an image belonging to the archive class will decompress the file contents and display them in a new Geeqie window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Play video by left click on image</guilabel>
+ </term>
+ <listitem>
+ <para>If selected, mouse left-click on an image belonging to the video class will start a program chosen in a box below.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Mouse button Back/Forward</guilabel>
+ </term>
+ <listitem>
+ <para>Some mice have additional buttons designated Back/Forward (mouse buttons 8 and 9). You may allocate any menu item to either of these buttons.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Debugging">
+ <title>Debugging</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Debug level</guilabel>
+ </term>
+ <listitem>
+ <para>Displayed when compiled with the option --enable-debug-log. This defines the verbosity of debug info sent to console and log window (0 disables the debug output).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Log Window max. lines</guilabel>
+ </term>
+ <listitem>
+ <para>The maximum number of data lines to be displayed. The window will show the most recent data.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsColor">\r
- <title id="titleGuideOptionsColor">Color management options</title>\r
- <para>Use of this function requires LCMS to be installed. If you are compiling from sources, LCMS functionality will be available if the development files dependencies are met.</para>\r
- <para>If you are using a pre-compiled distribution, availability depends on the package maintainer.</para>\r
- <para>\r
- Here one can defined color profiles to use. Color management can be enabled or disabled from\r
- <menuchoice>\r
- <guimenu>View</guimenu>\r
- <guimenuitem>Color Management</guimenuitem>\r
- </menuchoice>\r
- or\r
- <guiicon>\r
- <inlinegraphic fileref="gtk-select-color.png" />\r
- </guiicon>\r
- on the status bar.\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Type</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Either input color profile or screen color profile.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Menu name</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Name of the menu entry corresponding to the color profile.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>File</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Path to the color profile file.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsColor">
+ <title id="titleGuideOptionsColor">Color management options</title>
+ <para>Use of this function requires LCMS to be installed. If you are compiling from sources, LCMS functionality will be available if the development files dependencies are met.</para>
+ <para>If you are using a pre-compiled distribution, availability depends on the package maintainer.</para>
+ <para>
+ Here one can defined color profiles to use. Color management can be enabled or disabled from
+ <menuchoice>
+ <guimenu>View</guimenu>
+ <guimenuitem>Color Management</guimenuitem>
+ </menuchoice>
+ or
+ <guiicon>
+ <inlinegraphic fileref="gtk-select-color.png" />
+ </guiicon>
+ on the status bar.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Type</guilabel>
+ </term>
+ <listitem>
+ <para>Either input color profile or screen color profile.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Menu name</guilabel>
+ </term>
+ <listitem>
+ <para>Name of the menu entry corresponding to the color profile.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>File</guilabel>
+ </term>
+ <listitem>
+ <para>Path to the color profile file.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsFiltering">\r
- <title id="titleGuideOptionsFiltering">Files Options</title>\r
- <para>This section describes the options presented under the Files Tab of the preferences dialogue.</para>\r
- <para />\r
- <section id="Filters">\r
- <title>Filters</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Show hidden files or folders</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enables the display of hidden files and folders, also known as dot files.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Show parent folder</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enables the display of the parent folder as a double dot in the directories views.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Case sensitive sort</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Files and folders are sorted such that upper case letters occur before lower case letters.</para>\r
- <para>\r
- Enabled result: A, B, C, a, b, c\r
- <para />\r
- Disabled result: A, a, B, b, C, c\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Natural sort order</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Files and folders are sorted with the dot '.' treated as a special case, so the order is e.g. "event.c" "event.h" "eventgenerator.c". Also, files containing numbers are sorted as "file1" "file5" "file10".</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Disable file extension checks</guilabel>\r
- </term>\r
- <listitem>\r
- <para>During rename operations, allows files to be renamed to a different extension with no warning issued.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Disable file filtering</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enable this to allow Geeqie to list all files, even those that do not contain images.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Groupingsidecarextensions">\r
- <title>Grouping sidecar extensions</title>\r
- <para>This field defines which extensions will lead to file grouping. Grouped files will appear as a single entry in file views. This is useful, for example, when browsing directories containing two files for the same image (such as raw+jpeg files generated by some cameras).</para>\r
- <para>The group is represented by the first extension in the list for which a file exists.</para>\r
- <para>\r
- Each extension should include the starting dot and should be separated by a semi-colon from following entries. It is possible to use wild-cards corresponding to entries in the\r
- <emphasis>File Types Class</emphasis>\r
- below:\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <literal>%unknown</literal>\r
- </term>\r
- <listitem>\r
- expands to all files listed in class\r
- <emphasis>Unknown</emphasis>\r
- ,\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <literal>%image</literal>\r
- </term>\r
- <listitem>\r
- expands to all files listed in class\r
- <emphasis>Image</emphasis>\r
- ,\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <literal>%raw</literal>\r
- </term>\r
- <listitem>\r
- expands to all files listed in class\r
- <emphasis>RAW Image</emphasis>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <literal>%meta</literal>\r
- </term>\r
- <listitem>\r
- expands to all files listed in class\r
- <emphasis>Metadata</emphasis>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </para>\r
- <para />\r
- <para />\r
- </section>\r
- <section id="Filetypes">\r
- <title>File types</title>\r
- <para>\r
- This list contains the image formats that are understood by Geeqie. To disable a specific file type from being displayed, uncheck it's corresponding check-box. Filters can be edited by first selecting the line containing the item to be changed, then clicking the filter or description field, making any changes, then pressing\r
- <keycap>Enter</keycap>\r
- ; press\r
- <keycap>Escape</keycap>\r
- to cancel an active edit.\r
- </para>\r
- <note>\r
- <para>Unlike all other options in the dialogue, filter list changes are applied immediately.</para>\r
- </note>\r
- <para>\r
- The table consists of:\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Filter</guilabel>\r
- </term>\r
- <listitem>\r
- List of extensions this filter applies to, separated by a\r
- <code>;</code>\r
- . Each extension must be preceded by a dot.\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Description</guilabel>\r
- </term>\r
- <listitem>Brief description. This is not used elsewhere.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Class</guilabel>\r
- </term>\r
- <listitem>\r
- This may be used to define sets of file types, for use in the\r
- <emphasis>Grouping</emphasis>\r
- function described above. The drop-down list has 7 entries:\r
- <itemizedlist>\r
- <listitem>Unknown</listitem>\r
- <listitem>Image</listitem>\r
- <listitem>RAW Image</listitem>\r
- <listitem>Metadata</listitem>\r
- <listitem>Video</listitem>\r
- <listitem>Collection</listitem>\r
- <listitem>Document</listitem>\r
- <listitem>Archive (.zip, .rar etc.)</listitem>\r
- </itemizedlist>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Writable</guilabel>\r
- </term>\r
- <listitem>If this option is checked, Geeqie will try to write metadata to the image file itself. This, and the following option, are mutually exclusive.</listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Sidecar is allowed</guilabel>\r
- </term>\r
- <listitem>If this option is checked, Geeqie will try to write metadata to a sidecar file associated with the image. This, and the previous option, are mutually exclusive.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="list-add.png" />\r
- </guiicon>\r
- Add\r
- </guibutton>\r
- </term>\r
- <listitem>Adds a new blank line to the filter list, change the parameters to match the desired file type.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="list-remove.png" />\r
- </guiicon>\r
- Remove\r
- </guibutton>\r
- </term>\r
- <listitem>Removes the selected line from the filter list.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guibutton>Defaults</guibutton>\r
- </term>\r
- <listitem>Resets the filter list to the default values, discarding any customizations made by the user.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guibutton>Column Sorting</guibutton>\r
- </term>\r
- <listitem>Columns other than Filter can be sorted in ascending or descending order by clicking on the column header.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guibutton>Filter Search</guibutton>\r
- </term>\r
- <listitem>A search of the file extensions listed in the Filter column can be initiated either by typing <code>Ctrl + F</code> or by pressing any alpha-numeric key when the File Types table has focus.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsFiltering">
+ <title id="titleGuideOptionsFiltering">Files Options</title>
+ <para>This section describes the options presented under the Files Tab of the preferences dialogue.</para>
+ <para />
+ <section id="Filters">
+ <title>Filters</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Show hidden files or folders</guilabel>
+ </term>
+ <listitem>
+ <para>Enables the display of hidden files and folders, also known as dot files.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Show parent folder</guilabel>
+ </term>
+ <listitem>
+ <para>Enables the display of the parent folder as a double dot in the directories views.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Case sensitive sort</guilabel>
+ </term>
+ <listitem>
+ <para>Files and folders are sorted such that upper case letters occur before lower case letters.</para>
+ <para>
+ Enabled result: A, B, C, a, b, c
+ <para />
+ Disabled result: A, a, B, b, C, c
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Natural sort order</guilabel>
+ </term>
+ <listitem>
+ <para>Files and folders are sorted with the dot '.' treated as a special case, so the order is e.g. "event.c" "event.h" "eventgenerator.c". Also, files containing numbers are sorted as "file1" "file5" "file10".</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Disable file extension checks</guilabel>
+ </term>
+ <listitem>
+ <para>During rename operations, allows files to be renamed to a different extension with no warning issued.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Disable file filtering</guilabel>
+ </term>
+ <listitem>
+ <para>Enable this to allow Geeqie to list all files, even those that do not contain images.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Groupingsidecarextensions">
+ <title>Grouping sidecar extensions</title>
+ <para>This field defines which extensions will lead to file grouping. Grouped files will appear as a single entry in file views. This is useful, for example, when browsing directories containing two files for the same image (such as raw+jpeg files generated by some cameras).</para>
+ <para>The group is represented by the first extension in the list for which a file exists.</para>
+ <para>
+ Each extension should include the starting dot and should be separated by a semi-colon from following entries. It is possible to use wild-cards corresponding to entries in the
+ <emphasis>File Types Class</emphasis>
+ below:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <literal>%unknown</literal>
+ </term>
+ <listitem>
+ expands to all files listed in class
+ <emphasis>Unknown</emphasis>
+ ,
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <literal>%image</literal>
+ </term>
+ <listitem>
+ expands to all files listed in class
+ <emphasis>Image</emphasis>
+ ,
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <literal>%raw</literal>
+ </term>
+ <listitem>
+ expands to all files listed in class
+ <emphasis>RAW Image</emphasis>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <literal>%meta</literal>
+ </term>
+ <listitem>
+ expands to all files listed in class
+ <emphasis>Metadata</emphasis>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para />
+ <para />
+ </section>
+ <section id="Filetypes">
+ <title>File types</title>
+ <para>
+ This list contains the image formats that are understood by Geeqie. To disable a specific file type from being displayed, uncheck it's corresponding check-box. Filters can be edited by first selecting the line containing the item to be changed, then clicking the filter or description field, making any changes, then pressing
+ <keycap>Enter</keycap>
+ ; press
+ <keycap>Escape</keycap>
+ to cancel an active edit.
+ </para>
+ <note>
+ <para>Unlike all other options in the dialogue, filter list changes are applied immediately.</para>
+ </note>
+ <para>
+ The table consists of:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Filter</guilabel>
+ </term>
+ <listitem>
+ List of extensions this filter applies to, separated by a
+ <code>;</code>
+ . Each extension must be preceded by a dot.
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Description</guilabel>
+ </term>
+ <listitem>Brief description. This is not used elsewhere.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Class</guilabel>
+ </term>
+ <listitem>
+ This may be used to define sets of file types, for use in the
+ <emphasis>Grouping</emphasis>
+ function described above. The drop-down list has 7 entries:
+ <itemizedlist>
+ <listitem>Unknown</listitem>
+ <listitem>Image</listitem>
+ <listitem>RAW Image</listitem>
+ <listitem>Metadata</listitem>
+ <listitem>Video</listitem>
+ <listitem>Collection</listitem>
+ <listitem>Document</listitem>
+ <listitem>Archive (.zip, .rar etc.)</listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Writable</guilabel>
+ </term>
+ <listitem>If this option is checked, Geeqie will try to write metadata to the image file itself. This, and the following option, are mutually exclusive.</listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Sidecar is allowed</guilabel>
+ </term>
+ <listitem>If this option is checked, Geeqie will try to write metadata to a sidecar file associated with the image. This, and the previous option, are mutually exclusive.</listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="list-add.png" />
+ </guiicon>
+ Add
+ </guibutton>
+ </term>
+ <listitem>Adds a new blank line to the filter list, change the parameters to match the desired file type.</listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="list-remove.png" />
+ </guiicon>
+ Remove
+ </guibutton>
+ </term>
+ <listitem>Removes the selected line from the filter list.</listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guibutton>Defaults</guibutton>
+ </term>
+ <listitem>Resets the filter list to the default values, discarding any customizations made by the user.</listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guibutton>Column Sorting</guibutton>
+ </term>
+ <listitem>Columns other than Filter can be sorted in ascending or descending order by clicking on the column header.</listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guibutton>Filter Search</guibutton>
+ </term>
+ <listitem>A search of the file extensions listed in the Filter column can be initiated either by typing <code>Ctrl + F</code> or by pressing any alpha-numeric key when the File Types table has focus.</listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsGeneral">\r
- <title>General Options</title>\r
- <para>This section describes the options presented under the General Tab of the preferences dialog.</para>\r
- <section id="PreferencesThumbnails">\r
- <title>Thumbnails</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Selects the size of the thumbnails displayed throughout Geeqie, dimensions are width by height in pixels.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Quality</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Selects the method to use when scaling an image down for thumbnails:\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Nearest</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Fastest scaler, but results in poor thumbnail quality.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Tiles</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Thumbnail results are very close to bilinear, with better speed.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Bilinear</guilabel>\r
- </term>\r
- <listitem>\r
- <para>High quality results, moderately fast.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Cache thumbnails and sim. files</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Enable this to save thumbnails and\r
- <link linkend="CreateSimFiles">sim. files</link>\r
- to disk. Subsequent requests for a thumbnail will be faster, as will searches and find duplicates.\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use Geeqie thumbnail style and cache</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Thumbnails are stored in a folder hierarchy that mirrors the location of the source images. Thumbnails have the same name as the original appended by the file extension .png.</para>\r
- <para>\r
- The root of the hierarchy is:\r
- <para>\r
- <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>\r
- or, if $XDG_CACHE_HOME is not defined:\r
- <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>\r
- </para>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Store thumbnails local to image folder (non-standard)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- When enabled, Geeqie attempts to store cached thumbnails closer to the source image. This way multiple users can benefit from a single cache, thereby reducing wasted disk space.\r
- <para />\r
- Thumbnails have the same name as the original appended by the file extension .png.\r
- <para />\r
- The resulting location is the source image's folder, in a sub folder with the name\r
- <programlisting>.thumbnails</programlisting>\r
- <para />\r
- When the image source folder cannot be written, Geeqie falls back to saving the thumbnail in the user's home folder.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use standard thumbnail style and cache, shared with other applications</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- This will use a thumbnail caching method that is compatible with applications that use the standard thumbnail specification. When this option is enabled thumbnails will be stored in:\r
- <para>\r
- <programlisting>$XDG_CACHE_HOME/thumbnails/</programlisting>\r
- or, if $XDG_CACHE_HOME is not defined:\r
- <programlisting>$HOME/.cache/thumbnails/</programlisting>\r
- </para>\r
- <para>\r
- All thumbnails are stored in the same folder, with computer-generated filenames. Refer to\r
- <link linkend="GuideReferenceThumbnails">Thumbnails Reference</link>\r
- for additional details.\r
- </para>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use EXIF thumbnails when available</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Geeqie will extract thumbnail from EXIF data if available, instead of generating one. This will speed up thumbnails generation, but the EXIF thumbnail may be not in sync with the image if it was modified by a tool which did not also update the thumbnail data.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Thumbnail color management</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Where possible store thumbnails with an sRGB color profile.</para>\r
- <note>\r
- <para>Selecting this option will increase the time taken to generate thumbnails.</para>\r
- <para>You probably will want to deselect the "Use EXIF thumbnails" option.</para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Collection preview</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- If thumbnail caching is enabled and you open the\r
- <link linkend="GuideReferenceConfig">Collections folder</link>\r
- , \r
- Geeqie will display a preview of the collections as a thumbnail montage. This option limits the number of thumbnails displayed in each preview.\r
- <note>\r
- <para>ImageMagick is required for this feature.</para>\r
- </note>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="StarRatingCharacters">\r
- <title>Star Rating</title>\r
- <para>The characters used to display the Star Rating are defined here. They are defined as a hexadecimal Unicode character. The complete list of Unicode characters can be found in many places on the Internet.</para>\r
- </section>\r
- <section id="Slideshow">\r
- <title>Slide show</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Delay between image change</guilabel>\r
- </term>\r
- <listitem>Specifies the delay between images for slide shows, in seconds.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Random</guilabel>\r
- </term>\r
- <listitem>\r
- When enabled, slide show images will appear in random order.\r
- <note>\r
- <para>Random images are displayed such that each image appears once per cycle of all images. When the slide show repeat option is enabled, the image order is randomized after completing each cycle.</para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Repeat</guilabel>\r
- </term>\r
- <listitem>This will cause the slide show to loop indefinitely, it will continue with the first image after displaying the last image in the slide show list.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="ImageLoadingandCaching">\r
- <title>Image loading and caching</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Decoded image cache size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Limit the amount of memory available for caching images.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Preload next image</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enabling this option will cause Geeqie to read the next logical image from disk when idle, it will also retain the previously viewed image in memory. By reading the nearest images into memory, time to display the next image is reduced.</para>\r
- <note>\r
- <para>This option will increase Geeqie memory requirements, and may cause performance issues with very large images. If the use of Geeqie results in the system noticeably swapping memory to disk, try disabling this feature.</para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Refresh on file change</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Geeqie will monitor currently active images and folders for changes in their modification time, and update the display if it changes.</para>\r
- <note>\r
- <para>Disable this if the system will not go into sleep mode due to occasional disk activity from the time check, or if Geeqie updates too often for folders with continuously changing content.</para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="ExpandMenuToolbar">\r
- <title>Expand menu and toolbar</title>\r
- <para>Expand the menu and toolbar to the full width of the window.</para>\r
- <note>\r
- <para>Geeqie must be restarted for changes to take effect.</para>\r
- </note>\r
- </section>\r
- <section id="PredefinedKeywordTree">\r
- <title>Show predefined keyword tree</title>\r
- <para>Deselecting this option will hide the list of predefined keywords on the right-hand side of the keywords pane of the info sidebar.</para>\r
- <note>\r
- <para>Geeqie must be restarted for the change to take effect.</para>\r
- </note>\r
- <variablelist />\r
- </section>\r
- <section id="TimezoneDatabase">\r
- <title>Timezone Database</title>\r
- <para>\r
- The timezone database is used to correct exif time and date for UTC offset and Daylight Saving Time as described\r
- <link linkend="GuideReferenceUTC">here.</link>\r
- This option allows you to install or update the database. An Internet connection is required.\r
- </para>\r
- <variablelist />\r
- </section>\r
- <section id="OnLineHelpSearch">\r
- <title>On-line help search</title>\r
- <para>\r
- An internet search engine may be used to search the help files on Geeqie's website. The string used to conduct the search is defined here. In most cases it will be in one of two formats:\r
- <para />\r
- <code>https://www.search-engine.com/search?q=site:geeqie.org/help</code>\r
- <para />\r
- <code>https://www.search-engine.com/?q=site:geeqie.org/help'</code>\r
- </para>\r
- <variablelist />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsGeneral">
+ <title>General Options</title>
+ <para>This section describes the options presented under the General Tab of the preferences dialog.</para>
+ <section id="PreferencesThumbnails">
+ <title>Thumbnails</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Size</guilabel>
+ </term>
+ <listitem>
+ <para>Selects the size of the thumbnails displayed throughout Geeqie, dimensions are width by height in pixels.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Quality</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Selects the method to use when scaling an image down for thumbnails:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Nearest</guilabel>
+ </term>
+ <listitem>
+ <para>Fastest scaler, but results in poor thumbnail quality.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Tiles</guilabel>
+ </term>
+ <listitem>
+ <para>Thumbnail results are very close to bilinear, with better speed.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Bilinear</guilabel>
+ </term>
+ <listitem>
+ <para>High quality results, moderately fast.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Cache thumbnails and sim. files</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Enable this to save thumbnails and
+ <link linkend="CreateSimFiles">sim. files</link>
+ to disk. Subsequent requests for a thumbnail will be faster, as will searches and find duplicates.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Use Geeqie thumbnail style and cache</guilabel>
+ </term>
+ <listitem>
+ <para>Thumbnails are stored in a folder hierarchy that mirrors the location of the source images. Thumbnails have the same name as the original appended by the file extension .png.</para>
+ <para>
+ The root of the hierarchy is:
+ <para>
+ <programlisting>$XDG_CACHE_HOME/geeqie/thumbnails/</programlisting>
+ or, if $XDG_CACHE_HOME is not defined:
+ <programlisting>$HOME/.cache/geeqie/thumbnails/</programlisting>
+ </para>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Store thumbnails local to image folder (non-standard)</guilabel>
+ </term>
+ <listitem>
+ <para>
+ When enabled, Geeqie attempts to store cached thumbnails closer to the source image. This way multiple users can benefit from a single cache, thereby reducing wasted disk space.
+ <para />
+ Thumbnails have the same name as the original appended by the file extension .png.
+ <para />
+ The resulting location is the source image's folder, in a sub folder with the name
+ <programlisting>.thumbnails</programlisting>
+ <para />
+ When the image source folder cannot be written, Geeqie falls back to saving the thumbnail in the user's home folder.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Use standard thumbnail style and cache, shared with other applications</guilabel>
+ </term>
+ <listitem>
+ <para>
+ This will use a thumbnail caching method that is compatible with applications that use the standard thumbnail specification. When this option is enabled thumbnails will be stored in:
+ <para>
+ <programlisting>$XDG_CACHE_HOME/thumbnails/</programlisting>
+ or, if $XDG_CACHE_HOME is not defined:
+ <programlisting>$HOME/.cache/thumbnails/</programlisting>
+ </para>
+ <para>
+ All thumbnails are stored in the same folder, with computer-generated filenames. Refer to
+ <link linkend="GuideReferenceThumbnails">Thumbnails Reference</link>
+ for additional details.
+ </para>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Use EXIF thumbnails when available</guilabel>
+ </term>
+ <listitem>
+ <para>Geeqie will extract thumbnail from EXIF data if available, instead of generating one. This will speed up thumbnails generation, but the EXIF thumbnail may be not in sync with the image if it was modified by a tool which did not also update the thumbnail data.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Thumbnail color management</guilabel>
+ </term>
+ <listitem>
+ <para>Where possible store thumbnails with an sRGB color profile.</para>
+ <note>
+ <para>Selecting this option will increase the time taken to generate thumbnails.</para>
+ <para>You probably will want to deselect the "Use EXIF thumbnails" option.</para>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Collection preview</guilabel>
+ </term>
+ <listitem>
+ <para>
+ If thumbnail caching is enabled and you open the
+ <link linkend="GuideReferenceConfig">Collections folder</link>
+ ,
+ Geeqie will display a preview of the collections as a thumbnail montage. This option limits the number of thumbnails displayed in each preview.
+ <note>
+ <para>ImageMagick is required for this feature.</para>
+ </note>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="StarRatingCharacters">
+ <title>Star Rating</title>
+ <para>The characters used to display the Star Rating are defined here. They are defined as a hexadecimal Unicode character. The complete list of Unicode characters can be found in many places on the Internet.</para>
+ </section>
+ <section id="Slideshow">
+ <title>Slide show</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Delay between image change</guilabel>
+ </term>
+ <listitem>Specifies the delay between images for slide shows, in seconds.</listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Random</guilabel>
+ </term>
+ <listitem>
+ When enabled, slide show images will appear in random order.
+ <note>
+ <para>Random images are displayed such that each image appears once per cycle of all images. When the slide show repeat option is enabled, the image order is randomized after completing each cycle.</para>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Repeat</guilabel>
+ </term>
+ <listitem>This will cause the slide show to loop indefinitely, it will continue with the first image after displaying the last image in the slide show list.</listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="ImageLoadingandCaching">
+ <title>Image loading and caching</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Decoded image cache size</guilabel>
+ </term>
+ <listitem>
+ <para>Limit the amount of memory available for caching images.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Preload next image</guilabel>
+ </term>
+ <listitem>
+ <para>Enabling this option will cause Geeqie to read the next logical image from disk when idle, it will also retain the previously viewed image in memory. By reading the nearest images into memory, time to display the next image is reduced.</para>
+ <note>
+ <para>This option will increase Geeqie memory requirements, and may cause performance issues with very large images. If the use of Geeqie results in the system noticeably swapping memory to disk, try disabling this feature.</para>
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Refresh on file change</guilabel>
+ </term>
+ <listitem>
+ <para>Geeqie will monitor currently active images and folders for changes in their modification time, and update the display if it changes.</para>
+ <note>
+ <para>Disable this if the system will not go into sleep mode due to occasional disk activity from the time check, or if Geeqie updates too often for folders with continuously changing content.</para>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="ExpandMenuToolbar">
+ <title>Expand menu and toolbar</title>
+ <para>Expand the menu and toolbar to the full width of the window.</para>
+ <note>
+ <para>Geeqie must be restarted for changes to take effect.</para>
+ </note>
+ </section>
+ <section id="PredefinedKeywordTree">
+ <title>Show predefined keyword tree</title>
+ <para>Deselecting this option will hide the list of predefined keywords on the right-hand side of the keywords pane of the info sidebar.</para>
+ <note>
+ <para>Geeqie must be restarted for the change to take effect.</para>
+ </note>
+ <variablelist />
+ </section>
+ <section id="TimezoneDatabase">
+ <title>Timezone Database</title>
+ <para>
+ The timezone database is used to correct exif time and date for UTC offset and Daylight Saving Time as described
+ <link linkend="GuideReferenceUTC">here.</link>
+ This option allows you to install or update the database. An Internet connection is required.
+ </para>
+ <variablelist />
+ </section>
+ <section id="OnLineHelpSearch">
+ <title>On-line help search</title>
+ <para>
+ An internet search engine may be used to search the help files on Geeqie's website. The string used to conduct the search is defined here. In most cases it will be in one of two formats:
+ <para />
+ <code>https://www.search-engine.com/search?q=site:geeqie.org/help</code>
+ <para />
+ <code>https://www.search-engine.com/?q=site:geeqie.org/help'</code>
+ </para>
+ <variablelist />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsHidden">\r
- <title id="titleGuideOptionsHidden">Legacy Configuration File Options</title>\r
- <para />\r
- <para>\r
- This section describes the options not accessible by the graphical interface, these options exist to maintain behavior of older releases of Geeqie. To change these settings, edit the\r
- <link linkend="GuideReferenceConfig">Geeqie configuration file</link>\r
- .\r
- </para>\r
- <para>\r
- <emphasis role="strong">\r
- lazy_image_sync: [true\r
- <emphasis role="i">false</emphasis>\r
- ]\r
- </emphasis>\r
- : This will suppress the image view from changing when selecting a new folder; the current image will remain displayed until the user manually selects another image.\r
- </para>\r
- <para>\r
- <emphasis role="strong">\r
- place_dialogs_under_mouse: [true\r
- <emphasis role="i">false</emphasis>\r
- ]\r
- </emphasis>\r
- : Enabling this will cause new dialogs to initially position themselves such that they are under the current mouse position.\r
- </para>\r
- <para />\r
- <varlistentry>\r
- <term>\r
- <emphasis role="strong">scroll_reset_method: value</emphasis>\r
- : This will set the method used to set the scroll position, or visible region of a new image, value can be:\r
- </term>\r
- <listitem>0: Move to upper left corner.</listitem>\r
- <listitem>1: Center image.</listitem>\r
- <listitem>2: Maintain same visible region as previous image, if possible.</listitem>\r
- </varlistentry>\r
- <para>\r
- <emphasis role="strong">\r
- thumbnails.use_xvpics = [true\r
- <emphasis role="i">false</emphasis>\r
- ]\r
- </emphasis>\r
- : xvpics is a common thumbnail caching format used by several applications. Thumbnails are stored locally to the source image in a sub folder with the name\r
- <emphasis role="strong">.xvpics</emphasis>\r
- . Enabling this option will allow Geeqie to read thumbnails saved in the xvpics format.\r
- </para>\r
- <note>\r
- <para>Support for xvpics is read only, Geeqie can not generate thumbnails in this format.</para>\r
- </note>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsHidden">
+ <title id="titleGuideOptionsHidden">Legacy Configuration File Options</title>
+ <para />
+ <para>
+ This section describes the options not accessible by the graphical interface, these options exist to maintain behavior of older releases of Geeqie. To change these settings, edit the
+ <link linkend="GuideReferenceConfig">Geeqie configuration file</link>
+ .
+ </para>
+ <para>
+ <emphasis role="strong">
+ lazy_image_sync: [true
+ <emphasis role="i">false</emphasis>
+ ]
+ </emphasis>
+ : This will suppress the image view from changing when selecting a new folder; the current image will remain displayed until the user manually selects another image.
+ </para>
+ <para>
+ <emphasis role="strong">
+ place_dialogs_under_mouse: [true
+ <emphasis role="i">false</emphasis>
+ ]
+ </emphasis>
+ : Enabling this will cause new dialogs to initially position themselves such that they are under the current mouse position.
+ </para>
+ <para />
+ <varlistentry>
+ <term>
+ <emphasis role="strong">scroll_reset_method: value</emphasis>
+ : This will set the method used to set the scroll position, or visible region of a new image, value can be:
+ </term>
+ <listitem>0: Move to upper left corner.</listitem>
+ <listitem>1: Center image.</listitem>
+ <listitem>2: Maintain same visible region as previous image, if possible.</listitem>
+ </varlistentry>
+ <para>
+ <emphasis role="strong">
+ thumbnails.use_xvpics = [true
+ <emphasis role="i">false</emphasis>
+ ]
+ </emphasis>
+ : xvpics is a common thumbnail caching format used by several applications. Thumbnails are stored locally to the source image in a sub folder with the name
+ <emphasis role="strong">.xvpics</emphasis>
+ . Enabling this option will allow Geeqie to read thumbnails saved in the xvpics format.
+ </para>
+ <note>
+ <para>Support for xvpics is read only, Geeqie can not generate thumbnails in this format.</para>
+ </note>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsImage">\r
- <title>Image Options</title>\r
- <para>This section describes the options presented under the Image Tab of the preferences dialog.</para>\r
- <section id="Zoom">\r
- <title>Zoom</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Quality</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Selects the method used to scale the size of an image:\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Nearest</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Fastest scaler, but results in poor image quality.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Tiles</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Results are somewhat close to bilinear, with better speed.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Bilinear</guilabel>\r
- </term>\r
- <listitem>\r
- <para>High quality results, moderately fast.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use GPU acceleration via Clutter library</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Use alternate renderer. Geeqie must be compiled with the --enable-gpu-accel option.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Two pass zooming</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Enables Geeqie to first display a scaled image using the\r
- <emphasis>Nearest</emphasis>\r
- zoom quality. After image decoding is complete, the image is scaled again using the selected\r
- <emphasis>Zoom Quality</emphasis>\r
- method. This allows faster display of an image as it is decoded from the source file.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Zoom increment</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Adjusts the step size when zooming in or out on an image.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Zoom style</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Selects whether the zoom step size is applied as a geometric (n * step) or arithmetic (n + step) factor.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="FitImageToWindow">\r
- <title>Fit Image To Window</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Allow enlargement of image (max. size in %)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Enable this to allow Geeqie to increase the image size for images that are smaller than the current view area when the zoom is set to\r
- <emphasis>Fit image to window</emphasis>\r
- . This value sets the maximum expansion permitted in percent i.e. 100% is full-size.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Virtual window size (% of actual window)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- This value will set the virtual size of the window when\r
- <emphasis>Fit image to window</emphasis>\r
- is set. Instead of using the actual size of the window, the specified percentage of the window will be used. It allows one to keep a border around the image (values lower than 100%) or to auto zoom the image (values greater than 100%). It affects fullscreen mode too.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="TileSize">\r
- <title>Tile Size</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Tile size in pixels</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- This option is only available when GPU acceleration is not selected. It sets the size in pixels that large images are split into during rendering. Setting a larger value will reduce the tiling effect seen as the image is displayed, but will also slightly increase the delay until the first part of the image is seen.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Appearance">\r
- <title>Appearance</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Custom border color</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enable this to draw the image background (the area around the image) in the specified color.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Border color</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Use this color chooser to define the color to use as image background.</para>\r
- <note>\r
- <para>\r
- You may use the\r
- <emphasis>Virtual window size</emphasis>\r
- (see above) option to keep a border around the image in fullscreen mode.\r
- </para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Alpha channel color 1/2</guilabel>\r
- </term>\r
- <listitem>\r
- <para>These two colors define the checkerboard background used when images with an alpha channel are displayed.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsImage">
+ <title>Image Options</title>
+ <para>This section describes the options presented under the Image Tab of the preferences dialog.</para>
+ <section id="Zoom">
+ <title>Zoom</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Quality</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Selects the method used to scale the size of an image:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Nearest</guilabel>
+ </term>
+ <listitem>
+ <para>Fastest scaler, but results in poor image quality.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Tiles</guilabel>
+ </term>
+ <listitem>
+ <para>Results are somewhat close to bilinear, with better speed.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Bilinear</guilabel>
+ </term>
+ <listitem>
+ <para>High quality results, moderately fast.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Use GPU acceleration via Clutter library</guilabel>
+ </term>
+ <listitem>
+ <para>Use alternate renderer. Geeqie must be compiled with the --enable-gpu-accel option.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Two pass zooming</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Enables Geeqie to first display a scaled image using the
+ <emphasis>Nearest</emphasis>
+ zoom quality. After image decoding is complete, the image is scaled again using the selected
+ <emphasis>Zoom Quality</emphasis>
+ method. This allows faster display of an image as it is decoded from the source file.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Zoom increment</guilabel>
+ </term>
+ <listitem>
+ <para>Adjusts the step size when zooming in or out on an image.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Zoom style</guilabel>
+ </term>
+ <listitem>
+ <para>Selects whether the zoom step size is applied as a geometric (n * step) or arithmetic (n + step) factor.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="FitImageToWindow">
+ <title>Fit Image To Window</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Allow enlargement of image (max. size in %)</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Enable this to allow Geeqie to increase the image size for images that are smaller than the current view area when the zoom is set to
+ <emphasis>Fit image to window</emphasis>
+ . This value sets the maximum expansion permitted in percent i.e. 100% is full-size.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Virtual window size (% of actual window)</guilabel>
+ </term>
+ <listitem>
+ <para>
+ This value will set the virtual size of the window when
+ <emphasis>Fit image to window</emphasis>
+ is set. Instead of using the actual size of the window, the specified percentage of the window will be used. It allows one to keep a border around the image (values lower than 100%) or to auto zoom the image (values greater than 100%). It affects fullscreen mode too.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="TileSize">
+ <title>Tile Size</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Tile size in pixels</guilabel>
+ </term>
+ <listitem>
+ <para>
+ This option is only available when GPU acceleration is not selected. It sets the size in pixels that large images are split into during rendering. Setting a larger value will reduce the tiling effect seen as the image is displayed, but will also slightly increase the delay until the first part of the image is seen.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Appearance">
+ <title>Appearance</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Custom border color</guilabel>
+ </term>
+ <listitem>
+ <para>Enable this to draw the image background (the area around the image) in the specified color.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Border color</guilabel>
+ </term>
+ <listitem>
+ <para>Use this color chooser to define the color to use as image background.</para>
+ <note>
+ <para>
+ You may use the
+ <emphasis>Virtual window size</emphasis>
+ (see above) option to keep a border around the image in fullscreen mode.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Alpha channel color 1/2</guilabel>
+ </term>
+ <listitem>
+ <para>These two colors define the checkerboard background used when images with an alpha channel are displayed.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsKeywords">\r
- <title id="titleGuideOptionsKeywords">Keywords</title>\r
- <para>This section describes the keywords list used for autocompletion.</para>\r
- <para />\r
- <section id="KeywordSearch">\r
- <title>Keyword Search</title>\r
- <para />\r
- <para>Pressing the Search button will open a dialog which permits a recursive search to be made for keywords already attached to images. The result of the search is automatically appended to the existing list.</para>\r
- </section>\r
- <section id="KeywordList">\r
- <title>Keyword List</title>\r
- <para />\r
- <para>\r
- The list shows all keywords currently used for autocompletion. Text may be copy-pasted into the list or deleted from the list.\r
- <para />\r
- When the list is saved, duplicates will automatically be removed and the list sorted into alphabetical order.\r
- </para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsKeywords">
+ <title id="titleGuideOptionsKeywords">Keywords</title>
+ <para>This section describes the keywords list used for autocompletion.</para>
+ <para />
+ <section id="KeywordSearch">
+ <title>Keyword Search</title>
+ <para />
+ <para>Pressing the Search button will open a dialog which permits a recursive search to be made for keywords already attached to images. The result of the search is automatically appended to the existing list.</para>
+ </section>
+ <section id="KeywordList">
+ <title>Keyword List</title>
+ <para />
+ <para>
+ The list shows all keywords currently used for autocompletion. Text may be copy-pasted into the list or deleted from the list.
+ <para />
+ When the list is saved, duplicates will automatically be removed and the list sorted into alphabetical order.
+ </para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsLayout">\r
- <title id="titleGuideOptionsLayout">Window Layout</title>\r
- <para>\r
- This item is accessed via\r
- <menuchoice>\r
- <guimenu>Edit</guimenu>\r
- <guimenuitem>Configure this window</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Home Path</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- The path to be moved to when\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="user-home.png" />\r
- </guiicon>\r
- </guibutton>\r
- </code>\r
- is clicked.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Show date in directories list view</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The folder pane will show dates.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Start-up directory</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This may be set for each instance of Geeqie.</para>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>No change: Use the Current Working Directory. If called from a system menu rather than the command line, the Home directory will probably be used.</para>\r
- </listitem>\r
- <listitem>\r
- <para>Restore last path: Use the folder in use when Geeqie was previously closed.</para>\r
- </listitem>\r
- <listitem>\r
- <para>Home path: Use the folder specified in the Home Path box.</para>\r
- </listitem>\r
- </itemizedlist>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Layout</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- The Geeqie main window consists of three main panes: the\r
- <link linkend="GuideMainWindowFolderPane">folder pane</link>\r
- ,\r
- <link linkend="GuideMainWindowFilePane">file pane</link>\r
- and the\r
- <link linkend="GuideMainWindowImagePane">image pane</link>\r
- . Their position and order can be changed here. The four choices shown represent the basic layout of the main window, the difference being that each has the larger pane in a different location: right, bottom, left, and top.\r
- </para>\r
- <para>The numbers within each selection represent the order of the pane content.</para>\r
- <para>The order in which the panes are filled is determined by the three row list located below the layout selection. The three numbered rows correspond to the three numbered regions of the selected layout. To change the order of the list, drag a row to the desired location within the list.</para>\r
- <note>\r
- <para>In this dialogue the file and image panes are labeled as such, however for historical reasons the folder pane is labeled as tools.</para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsLayout">
+ <title id="titleGuideOptionsLayout">Window Layout</title>
+ <para>
+ This item is accessed via
+ <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Configure this window</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Home Path</guilabel>
+ </term>
+ <listitem>
+ <para>
+ The path to be moved to when
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="user-home.png" />
+ </guiicon>
+ </guibutton>
+ </code>
+ is clicked.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Show date in directories list view</guilabel>
+ </term>
+ <listitem>
+ <para>The folder pane will show dates.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Start-up directory</guilabel>
+ </term>
+ <listitem>
+ <para>This may be set for each instance of Geeqie.</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>No change: Use the Current Working Directory. If called from a system menu rather than the command line, the Home directory will probably be used.</para>
+ </listitem>
+ <listitem>
+ <para>Restore last path: Use the folder in use when Geeqie was previously closed.</para>
+ </listitem>
+ <listitem>
+ <para>Home path: Use the folder specified in the Home Path box.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Layout</guilabel>
+ </term>
+ <listitem>
+ <para>
+ The Geeqie main window consists of three main panes: the
+ <link linkend="GuideMainWindowFolderPane">folder pane</link>
+ ,
+ <link linkend="GuideMainWindowFilePane">file pane</link>
+ and the
+ <link linkend="GuideMainWindowImagePane">image pane</link>
+ . Their position and order can be changed here. The four choices shown represent the basic layout of the main window, the difference being that each has the larger pane in a different location: right, bottom, left, and top.
+ </para>
+ <para>The numbers within each selection represent the order of the pane content.</para>
+ <para>The order in which the panes are filled is determined by the three row list located below the layout selection. The three numbered rows correspond to the three numbered regions of the selected layout. To change the order of the list, drag a row to the desired location within the list.</para>
+ <note>
+ <para>In this dialogue the file and image panes are labeled as such, however for historical reasons the folder pane is labeled as tools.</para>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideOptionsMain">\r
- <title id="titleGuideOptionsMain">Preferences</title>\r
- <para>There are two sets of preferences in Geeqie: those set via the main Preferences tabbed dialogue, and those set either via a menu entry or by editing a configuration file.</para>\r
-\r
- <para>\r
- This chapter explains in detail the main Geeqie preferences dialog, which is accessed via\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>O</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>Edit</guimenu>\r
- <guimenuitem>Preferences</guimenuitem>\r
- </menuchoice>\r
- or\r
- <guiicon>\r
- <inlinegraphic fileref="preferences-desktop.png" />\r
- </guiicon>\r
- on the Toolbar.\r
- </para>\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsGeneral.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsImage.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsOSD.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsWindow.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsKeyboard.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsFiltering.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsMetadata.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsKeywords.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsColor.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsStereo.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsBehavior.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsToolbar.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsAdvanced.xml" />\r
- <para />\r
-\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideOptionsMain">
+ <title id="titleGuideOptionsMain">Preferences</title>
+ <para>There are two sets of preferences in Geeqie: those set via the main Preferences tabbed dialogue, and those set either via a menu entry or by editing a configuration file.</para>
+
+ <para>
+ This chapter explains in detail the main Geeqie preferences dialog, which is accessed via
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>O</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Preferences</guimenuitem>
+ </menuchoice>
+ or
+ <guiicon>
+ <inlinegraphic fileref="preferences-desktop.png" />
+ </guiicon>
+ on the Toolbar.
+ </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsGeneral.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsImage.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsOSD.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsWindow.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsKeyboard.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsFiltering.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsMetadata.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsKeywords.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsColor.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsStereo.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsBehavior.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsToolbar.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOptionsAdvanced.xml" />
+ <para />
+
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsMetadata">\r
- <title id="titleGuideOptionsMetadata">Metadata</title>\r
- <para>This section describes the options for metadata writing.</para>\r
- <para />\r
- <para>\r
- The settings in the\r
- <link linkend="Filetypes">Files tab of Preferences</link>\r
- influence whether an attempt is made to write metadata to the file itself, to a sidecar file or to a local folder.\r
- </para>\r
- <para>\r
- Refer also to\r
- <link linkend="GuideReferenceMetadata" endterm="titleGuideReferenceMetadata" />\r
- in the Reference section.\r
- </para>\r
- <section id="MetadataWritingProcess">\r
- <title id="titleMetadataWritingProcess">Metadata writing process</title>\r
- <para>\r
- When writing metadata, Geeqie will follow three steps. This process will stop when the first successful write occurs.\r
- <orderedlist>\r
- <listitem>\r
- <para>\r
- <guilabel>Save metadata in image files, resp. sidecar files, according to the XMP standard</guilabel>\r
- <para />\r
- If checked, Geeqie will attempt to write metadata to the file itself, or to an associated XMP sidecar file\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Save metadata in '.metadata' folder, local to image folder (non-standard)</guilabel>\r
- <para />\r
- If checked, Geeqie will attempt to write to an xmp file in a local .metadata folder\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Save metadata in Geeqie private directory</guilabel>\r
- <para />\r
- If neither of the above are successful, Geeqie will write to an xmp file in the folder\r
- <programlisting>$HOME/.local/share/geeqie/metadata</programlisting>\r
- </para>\r
- </listitem>\r
- </orderedlist>\r
- </para>\r
- <para>When writing to local metadata folders, the directory structure duplicates that of the location of the source files.</para>\r
- </section>\r
- <section id="WriteToImageFiles">\r
- <title>Step 1: Write to image files</title>\r
- <para>If Step 1 above was successful, the following options take effect:</para>\r
- <itemizedlist>\r
- <listitem>\r
- <para>\r
- <guilabel>Store metadata also in legacy IPTC tags (converted according to IPTC4XMP standard)</guilabel>\r
- <para />\r
- If checked, Geeqie will write IPTC tags as defined in\r
- <link linkend="GuideReferenceStandards" endterm="titleGuideReferenceStandards" />\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Warn if the image files are not writeable</guilabel>\r
- <para />\r
- If checked, open a warning dialogue if the file is not writeable\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Ask before writing to image files</guilabel>\r
- <para />\r
- If checked, open a confirmation dialogue before writing to the file\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Create sidecar files named image.ext.xmp (as opposed to image.xmp)</guilabel>\r
- <para />\r
- If checked, new sidecar files will use image.ext.xmp naming scheme\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- </section>\r
- <section id="WriteToGeeqiePrivateFiles">\r
- <title>Steps 2 and 3: Write to Geeqie private files</title>\r
- <para>If Step 2 or 3 above was successful, the following option takes effect:</para>\r
- <itemizedlist>\r
- <listitem>\r
- <para>\r
- <guilabel>Use GQview legacy metadata format (supports only keywords and comments) instead of XMP</guilabel>\r
- <para />\r
- If checked, Geeqie will write metadata in GQview legacy files (file extension .meta) format\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- </section>\r
- <section id="MetadataMiscellaneous">\r
- <title>Miscellaneous</title>\r
- <itemizedlist>\r
- <listitem>\r
- <para>\r
- <guilabel>Write the same description tags (keywords, comment, title) to all grouped sidecars</guilabel>\r
- <para />\r
- If checked the same descriptive tags are written to all files in a group. File grouping is as defined in the\r
- <link linkend="Groupingsidecarextensions">Files tab</link>\r
- of main Preferences. Technical tags (exif) are handled separately for each file.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Allow keywords to differ only in case</guilabel>\r
- <para />\r
- If checked, permits keywords to be case-sensitive (e.g.\r
- <emphasis>Place</emphasis>\r
- and\r
- <emphasis>place</emphasis>\r
- are two different keywords)\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Write altered image orientation to the metadata</guilabel>\r
- <para />\r
- If checked, the results of orientation commands (Rotate, Mirror and Flip) issued on an image will be written to metadata either automatically as specified below or when manually initiated. This option also affects the\r
- <link linkend="Editmenu">Auto rotate image using EXIF information</link>\r
- menu item.\r
- </para>\r
- <warning>\r
- <para>If this option is not checked, the results of orientation commands will be lost when Geeqie closes.</para>\r
- <para>Do not change this option while you have temporary rotations applied to images.</para>\r
- </warning>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="AutoSaveOptions">\r
- <title>Auto-save options</title>\r
- <itemizedlist>\r
- <listitem>\r
- <para>\r
- <guilabel>Write metadata after timeout</guilabel>\r
- <para />\r
- If checked, metadata writes will be made automatically at the defined interval. Warning dialogues will be issued if required.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Write metadata on image change</guilabel>\r
- <para />\r
- If checked, metadata writes will be made when you move focus to another image.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- <guilabel>Write metadata on directory change</guilabel>\r
- <para />\r
- If checked, metadata writes will be made when you move focus to another folder.\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="PreLoadMetadata">\r
- <title>Pre-load metadata</title>\r
- <itemizedlist>\r
- <listitem>\r
- <para>\r
- <guilabel>Read metadata in background</guilabel>\r
- <para />\r
- Using the folder sorting options:\r
- <para />\r
- <guilabel>Exif date original</guilabel>\r
- <para />\r
- <guilabel>Exif date digitized</guilabel>\r
- <para />\r
- <guilabel>Rating</guilabel>\r
- <para />\r
- requires metadata to be read from all files in a folder before the sort action can be made. If a folder contains a large number of file, this can take a noticeable period of time.\r
- <para />\r
- If this option is checked, Geeqie will automatically read the required metatada in the background as soon as a folder is opened. This will reduce the amount of time you have to wait until the sort is completed.\r
- <para />\r
- If you do not use these sort options, leave this option unchecked.\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsMetadata">
+ <title id="titleGuideOptionsMetadata">Metadata</title>
+ <para>This section describes the options for metadata writing.</para>
+ <para />
+ <para>
+ The settings in the
+ <link linkend="Filetypes">Files tab of Preferences</link>
+ influence whether an attempt is made to write metadata to the file itself, to a sidecar file or to a local folder.
+ </para>
+ <para>
+ Refer also to
+ <link linkend="GuideReferenceMetadata" endterm="titleGuideReferenceMetadata" />
+ in the Reference section.
+ </para>
+ <section id="MetadataWritingProcess">
+ <title id="titleMetadataWritingProcess">Metadata writing process</title>
+ <para>
+ When writing metadata, Geeqie will follow three steps. This process will stop when the first successful write occurs.
+ <orderedlist>
+ <listitem>
+ <para>
+ <guilabel>Save metadata in image files, resp. sidecar files, according to the XMP standard</guilabel>
+ <para />
+ If checked, Geeqie will attempt to write metadata to the file itself, or to an associated XMP sidecar file
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Save metadata in '.metadata' folder, local to image folder (non-standard)</guilabel>
+ <para />
+ If checked, Geeqie will attempt to write to an xmp file in a local .metadata folder
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Save metadata in Geeqie private directory</guilabel>
+ <para />
+ If neither of the above are successful, Geeqie will write to an xmp file in the folder
+ <programlisting>$HOME/.local/share/geeqie/metadata</programlisting>
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <para>When writing to local metadata folders, the directory structure duplicates that of the location of the source files.</para>
+ </section>
+ <section id="WriteToImageFiles">
+ <title>Step 1: Write to image files</title>
+ <para>If Step 1 above was successful, the following options take effect:</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Store metadata also in legacy IPTC tags (converted according to IPTC4XMP standard)</guilabel>
+ <para />
+ If checked, Geeqie will write IPTC tags as defined in
+ <link linkend="GuideReferenceStandards" endterm="titleGuideReferenceStandards" />
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Warn if the image files are not writeable</guilabel>
+ <para />
+ If checked, open a warning dialogue if the file is not writeable
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Ask before writing to image files</guilabel>
+ <para />
+ If checked, open a confirmation dialogue before writing to the file
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Create sidecar files named image.ext.xmp (as opposed to image.xmp)</guilabel>
+ <para />
+ If checked, new sidecar files will use image.ext.xmp naming scheme
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section id="WriteToGeeqiePrivateFiles">
+ <title>Steps 2 and 3: Write to Geeqie private files</title>
+ <para>If Step 2 or 3 above was successful, the following option takes effect:</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Use GQview legacy metadata format (supports only keywords and comments) instead of XMP</guilabel>
+ <para />
+ If checked, Geeqie will write metadata in GQview legacy files (file extension .meta) format
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section id="MetadataMiscellaneous">
+ <title>Miscellaneous</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Write the same description tags (keywords, comment, title) to all grouped sidecars</guilabel>
+ <para />
+ If checked the same descriptive tags are written to all files in a group. File grouping is as defined in the
+ <link linkend="Groupingsidecarextensions">Files tab</link>
+ of main Preferences. Technical tags (exif) are handled separately for each file.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Allow keywords to differ only in case</guilabel>
+ <para />
+ If checked, permits keywords to be case-sensitive (e.g.
+ <emphasis>Place</emphasis>
+ and
+ <emphasis>place</emphasis>
+ are two different keywords)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Write altered image orientation to the metadata</guilabel>
+ <para />
+ If checked, the results of orientation commands (Rotate, Mirror and Flip) issued on an image will be written to metadata either automatically as specified below or when manually initiated. This option also affects the
+ <link linkend="Editmenu">Auto rotate image using EXIF information</link>
+ menu item.
+ </para>
+ <warning>
+ <para>If this option is not checked, the results of orientation commands will be lost when Geeqie closes.</para>
+ <para>Do not change this option while you have temporary rotations applied to images.</para>
+ </warning>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="AutoSaveOptions">
+ <title>Auto-save options</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Write metadata after timeout</guilabel>
+ <para />
+ If checked, metadata writes will be made automatically at the defined interval. Warning dialogues will be issued if required.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Write metadata on image change</guilabel>
+ <para />
+ If checked, metadata writes will be made when you move focus to another image.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>Write metadata on directory change</guilabel>
+ <para />
+ If checked, metadata writes will be made when you move focus to another folder.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="PreLoadMetadata">
+ <title>Pre-load metadata</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Read metadata in background</guilabel>
+ <para />
+ Using the folder sorting options:
+ <para />
+ <guilabel>Exif date original</guilabel>
+ <para />
+ <guilabel>Exif date digitized</guilabel>
+ <para />
+ <guilabel>Rating</guilabel>
+ <para />
+ requires metadata to be read from all files in a folder before the sort action can be made. If a folder contains a large number of file, this can take a noticeable period of time.
+ <para />
+ If this option is checked, Geeqie will automatically read the required metatada in the background as soon as a folder is opened. This will reduce the amount of time you have to wait until the sort is completed.
+ <para />
+ If you do not use these sort options, leave this option unchecked.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsOSD">\r
- <title>OverlayScreen Display</title>\r
- <para>This section describes the options presented under the OSD Tab of the preferences dialog.</para>\r
- <section id="OverlayScreenDisplay">\r
- <title>Overlay Screen Display</title>\r
- <para>The contents of the Overlay Screen Display is defined by the Image Overlay Template. This template is easily customised to display a wide range of data.</para>\r
- <para>\r
- The format of each entry is:\r
- <programlisting>%tag[:max_length][:extra]%</programlisting>\r
- </para>\r
- <table frame="all">\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <tbody>\r
- <row>\r
- <entry>\r
- <emphasis role="strong">Tag</emphasis>\r
- </entry>\r
- <entry>\r
- <emphasis role="strong">Replaced by</emphasis>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>name</entry>\r
- <entry>Filename of the picture</entry>\r
- </row>\r
- <row>\r
- <entry>path</entry>\r
- <entry>Full path, including filename, of the picture</entry>\r
- </row>\r
- <row>\r
- <entry>collection</entry>\r
- <entry>Name of the collection</entry>\r
- </row>\r
- <row>\r
- <entry>number</entry>\r
- <entry>Current number of image in the list</entry>\r
- </row>\r
- <row>\r
- <entry>total</entry>\r
- <entry>Total number of images</entry>\r
- </row>\r
- <row>\r
- <entry>date</entry>\r
- <entry>File date</entry>\r
- </row>\r
- <row>\r
- <entry>size</entry>\r
- <entry>File size</entry>\r
- </row>\r
- <row>\r
- <entry>width</entry>\r
- <entry>Image width</entry>\r
- </row>\r
- <row>\r
- <entry>height</entry>\r
- <entry>Image height</entry>\r
- </row>\r
- <row>\r
- <entry>res</entry>\r
- <entry>Image resolution</entry>\r
- </row>\r
- <row>\r
- <entry>keywords</entry>\r
- <entry>Image keywords from metadata</entry>\r
- </row>\r
- <row>\r
- <entry>comment</entry>\r
- <entry>Image comment from XMP metadata</entry>\r
- </row>\r
- <row>\r
- <entry>imagecomment</entry>\r
- <entry>JPEG image comment</entry>\r
- </row>\r
- <row>\r
- <entry>rating</entry>\r
- <entry>Image rating</entry>\r
- </row>\r
- <row>\r
- <entry><meta_tag></entry>\r
- <entry>The Exif, XMP, or IPTC tag from metadata</entry>\r
- </row>\r
- <row>\r
- <entry>lua/<lua_script>/</entry>\r
- <entry>The output of a Lua script file</entry>\r
- </row>\r
- <row>\r
- <entry>lua//<lua_command></entry>\r
- <entry>The output of a Lua command</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <para>\r
- As an aide, in addition to standard metadata tags, Geeqie provides a number of\r
- <link linkend="formatted_exif">pre-formatted tags</link>\r
- .\r
- </para>\r
- <para>Examples of usage are:</para>\r
- <para>\r
- <programlisting xml:space="preserve">\r
- %keywords%\r
- %Exif.Photo.DateTimeOriginal%\r
- %lua/jpeg_comment.lua/:12%\r
- %lua//return(os.date())%\r
- </programlisting>\r
- </para>\r
- <para>\r
- Refer to\r
- <link linkend="GuideReferenceLua">Lua Extensions</link>\r
- for further information.\r
- </para>\r
- <para>\r
- The length of displayed data can be limited by using the\r
- <emphasis role="italic">:max_length</emphasis>\r
- parameter. The following example will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation.\r
- <programlisting>%formatted.Camera:20%</programlisting>\r
- </para>\r
- <para>\r
- If two or more variables are connected with the\r
- <code>|</code>\r
- character, the variables are displayed with a separator. For example::\r
- <programlisting>%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%</programlisting>\r
- could show:\r
- <programlisting>"1/20s - 400 - 80 mm"</programlisting>\r
- Or, if there is no ISO information in the Exif data:\r
- <programlisting>"1/200 - 80 mm"</programlisting>\r
- </para>\r
- <para>If there is no data for a requested tag, the line is not displayed.</para>\r
- <para>\r
- The\r
- <emphasis role="italic">:extra</emphasis>\r
- parameter may be used to format the output by prepending and appending a text string to the displayed item.\r
- </para>\r
- <para>\r
- The special character\r
- <code>*</code>\r
- is used to mark the position of the Tag data item. If no\r
- <code>*</code>\r
- is present, the extra string is just appended to the standard data displayed. Any "\n" is replaced by a newline on display.\r
- <link linkend="GuideReferenceStandards">Pango mark up</link>\r
- is accepted in both left and right parts. If the data item is empty, nothing will be displayed.\r
- </para>\r
- <para>Examples:</para>\r
- <table>\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <tbody>\r
- <row>\r
- <entry>\r
- <emphasis role="strong">Template</emphasis>\r
- </entry>\r
- <entry>\r
- <emphasis role="strong">Example display</emphasis>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- %name:\r
- <i>*</i>\n%\r
- </entry>\r
- <entry>\r
- <emphasis role="italic">filename001.jpg</emphasis>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>%size:\n%</entry>\r
- <entry>123456</entry>\r
- </row>\r
- <row>\r
- <entry>%formatted.ISOSpeedRating:ISO *%</entry>\r
- <entry>ISO 100</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- %collection:Collection:\r
- <b>*</b>\r
- \n%\r
- </entry>\r
- <entry>\r
- Collection:\r
- <emphasis role="strong">my_new_collection</emphasis>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <para />\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="preferences-desktop-font.png" />\r
- </guiicon>\r
- </guibutton>\r
- <guilabel>Font</guilabel>\r
- ,\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="gtk-color-picker.png" />\r
- </guiicon>\r
- </guibutton>\r
- <guilabel>Text</guilabel>\r
- ,\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="gtk-color-picker.png" />\r
- </guiicon>\r
- </guibutton>\r
- <guilabel>Background</guilabel>\r
- </term>\r
- <listitem>The font used for the Overlay Screen Display, as well as the font colour and background colour, may be set via these buttons. Colour transparency can also be set.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="help-contents.png" />\r
- </guiicon>\r
- </guibutton>\r
- <guilabel>Help</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Show syntax help</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Defaults</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Restore default image overlay template</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsOSD">
+ <title>OverlayScreen Display</title>
+ <para>This section describes the options presented under the OSD Tab of the preferences dialog.</para>
+ <section id="OverlayScreenDisplay">
+ <title>Overlay Screen Display</title>
+ <para>The contents of the Overlay Screen Display is defined by the Image Overlay Template. This template is easily customised to display a wide range of data.</para>
+ <para>
+ The format of each entry is:
+ <programlisting>%tag[:max_length][:extra]%</programlisting>
+ </para>
+ <table frame="all">
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <tbody>
+ <row>
+ <entry>
+ <emphasis role="strong">Tag</emphasis>
+ </entry>
+ <entry>
+ <emphasis role="strong">Replaced by</emphasis>
+ </entry>
+ </row>
+ <row>
+ <entry>name</entry>
+ <entry>Filename of the picture</entry>
+ </row>
+ <row>
+ <entry>path</entry>
+ <entry>Full path, including filename, of the picture</entry>
+ </row>
+ <row>
+ <entry>collection</entry>
+ <entry>Name of the collection</entry>
+ </row>
+ <row>
+ <entry>number</entry>
+ <entry>Current number of image in the list</entry>
+ </row>
+ <row>
+ <entry>total</entry>
+ <entry>Total number of images</entry>
+ </row>
+ <row>
+ <entry>date</entry>
+ <entry>File date</entry>
+ </row>
+ <row>
+ <entry>size</entry>
+ <entry>File size</entry>
+ </row>
+ <row>
+ <entry>width</entry>
+ <entry>Image width</entry>
+ </row>
+ <row>
+ <entry>height</entry>
+ <entry>Image height</entry>
+ </row>
+ <row>
+ <entry>res</entry>
+ <entry>Image resolution</entry>
+ </row>
+ <row>
+ <entry>keywords</entry>
+ <entry>Image keywords from metadata</entry>
+ </row>
+ <row>
+ <entry>comment</entry>
+ <entry>Image comment from XMP metadata</entry>
+ </row>
+ <row>
+ <entry>imagecomment</entry>
+ <entry>JPEG image comment</entry>
+ </row>
+ <row>
+ <entry>rating</entry>
+ <entry>Image rating</entry>
+ </row>
+ <row>
+ <entry><meta_tag></entry>
+ <entry>The Exif, XMP, or IPTC tag from metadata</entry>
+ </row>
+ <row>
+ <entry>lua/<lua_script>/</entry>
+ <entry>The output of a Lua script file</entry>
+ </row>
+ <row>
+ <entry>lua//<lua_command></entry>
+ <entry>The output of a Lua command</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>
+ As an aide, in addition to standard metadata tags, Geeqie provides a number of
+ <link linkend="formatted_exif">pre-formatted tags</link>
+ .
+ </para>
+ <para>Examples of usage are:</para>
+ <para>
+ <programlisting xml:space="preserve">
+ %keywords%
+ %Exif.Photo.DateTimeOriginal%
+ %lua/jpeg_comment.lua/:12%
+ %lua//return(os.date())%
+ </programlisting>
+ </para>
+ <para>
+ Refer to
+ <link linkend="GuideReferenceLua">Lua Extensions</link>
+ for further information.
+ </para>
+ <para>
+ The length of displayed data can be limited by using the
+ <emphasis role="italic">:max_length</emphasis>
+ parameter. The following example will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation.
+ <programlisting>%formatted.Camera:20%</programlisting>
+ </para>
+ <para>
+ If two or more variables are connected with the
+ <code>|</code>
+ character, the variables are displayed with a separator. For example::
+ <programlisting>%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%</programlisting>
+ could show:
+ <programlisting>"1/20s - 400 - 80 mm"</programlisting>
+ Or, if there is no ISO information in the Exif data:
+ <programlisting>"1/200 - 80 mm"</programlisting>
+ </para>
+ <para>If there is no data for a requested tag, the line is not displayed.</para>
+ <para>
+ The
+ <emphasis role="italic">:extra</emphasis>
+ parameter may be used to format the output by prepending and appending a text string to the displayed item.
+ </para>
+ <para>
+ The special character
+ <code>*</code>
+ is used to mark the position of the Tag data item. If no
+ <code>*</code>
+ is present, the extra string is just appended to the standard data displayed. Any "\n" is replaced by a newline on display.
+ <link linkend="GuideReferenceStandards">Pango mark up</link>
+ is accepted in both left and right parts. If the data item is empty, nothing will be displayed.
+ </para>
+ <para>Examples:</para>
+ <table>
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <tbody>
+ <row>
+ <entry>
+ <emphasis role="strong">Template</emphasis>
+ </entry>
+ <entry>
+ <emphasis role="strong">Example display</emphasis>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ %name:
+ <i>*</i>\n%
+ </entry>
+ <entry>
+ <emphasis role="italic">filename001.jpg</emphasis>
+ </entry>
+ </row>
+ <row>
+ <entry>%size:\n%</entry>
+ <entry>123456</entry>
+ </row>
+ <row>
+ <entry>%formatted.ISOSpeedRating:ISO *%</entry>
+ <entry>ISO 100</entry>
+ </row>
+ <row>
+ <entry>
+ %collection:Collection:
+ <b>*</b>
+ \n%
+ </entry>
+ <entry>
+ Collection:
+ <emphasis role="strong">my_new_collection</emphasis>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para />
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="preferences-desktop-font.png" />
+ </guiicon>
+ </guibutton>
+ <guilabel>Font</guilabel>
+ ,
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="gtk-color-picker.png" />
+ </guiicon>
+ </guibutton>
+ <guilabel>Text</guilabel>
+ ,
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="gtk-color-picker.png" />
+ </guiicon>
+ </guibutton>
+ <guilabel>Background</guilabel>
+ </term>
+ <listitem>The font used for the Overlay Screen Display, as well as the font colour and background colour, may be set via these buttons. Colour transparency can also be set.</listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="help-contents.png" />
+ </guiicon>
+ </guibutton>
+ <guilabel>Help</guilabel>
+ </term>
+ <listitem>
+ <para>Show syntax help</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Defaults</guilabel>
+ </term>
+ <listitem>
+ <para>Restore default image overlay template</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsToolbar">\r
- <title>Toolbar</title>\r
- <para>\r
- This dialogue enables you to change the items displayed on either the Main Toolbar or the Status Toolbar.\r
- <para />\r
- The initial display shows the current setup. You may re-order these items by right-clicking on any item.\r
- <para />\r
- Additional items may be included by clicking on the "Plus" symbol at the bottom of the tab. A list of all available options is displayed.\r
- </para>\r
- <para>Most of the Geeqie menu items are available, plus any desktop (Plugins) files.</para>\r
- <note>\r
- <para>\r
- If you select a desktop file, ensure that it includes an icon - the desktop file format is described in the\r
- <link linkend="GuideReferenceStandards">Standards section</link>\r
- </para>\r
- </note>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsToolbar">
+ <title>Toolbar</title>
+ <para>
+ This dialogue enables you to change the items displayed on either the Main Toolbar or the Status Toolbar.
+ <para />
+ The initial display shows the current setup. You may re-order these items by right-clicking on any item.
+ <para />
+ Additional items may be included by clicking on the "Plus" symbol at the bottom of the tab. A list of all available options is displayed.
+ </para>
+ <para>Most of the Geeqie menu items are available, plus any desktop (Plugins) files.</para>
+ <note>
+ <para>
+ If you select a desktop file, ensure that it includes an icon - the desktop file format is described in the
+ <link linkend="GuideReferenceStandards">Standards section</link>
+ </para>
+ </note>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOptionsWindow">\r
- <title>Window Options</title>\r
- <para>This section describes the options presented under the Windows Tab of the preferences dialog.</para>\r
- <section id="State">\r
- <title>State</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Remember session</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This will maintain windows size and position between Geeqie sessions.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use saved window positions also for new windows</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- A new window opened by menu\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>N</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>New Window</guimenuitem>\r
- </menuchoice>\r
- will use the saved window positions also.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Remember window workspace</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Remember which workspace a window was displayed in.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Remember tool state</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Maintains the selection set by\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>L</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>View</guimenu>\r
- <guimenuitem>File and Folders</guimenuitem>\r
- <guimenuitem>Float File List</guimenuitem>\r
- </menuchoice>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Remember dialog window positions</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This will maintain dialog windows size and position between Geeqie sessions.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Show window IDs</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Show the window ID in the titlebar of each window. When multiple Geeqie windows are opened, this option shows a unique identifier for each window. It may be used in conjunction with the command line option:\r
- <link linkend="Remotecommands">\r
- <programlisting>--remote --id:<ID></programlisting>\r
- </link>\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Use current layout for default</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Press the <code>Set</code> button to store the current window layout for use as the default for all new windows.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Size">\r
- <title>Size</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Fit window to image when tools are hidden/floating</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The main window will be resized to accommodate each image's size and proportions when the image pane is the only one visible within the window.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Limit size when auto-sizing window</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This will restrict the maximum size a window can grow to automatically fit an image. The value represents the percentage of the desktop size in width and height.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="FullScreen">\r
- <title>Full Screen</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Location</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Selects the location and position of the full screen window. 'Determined by window manager' will leave the window placement up to the window manager. 'Active screen' places the window on the same screen as the Geeqie main window. 'Active monitor' does the same, but limits the full screen window size to the monitor containing the main window. The remaining choices are dependent on the multiple monitor configuration.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Smooth image flip</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This option delays the image change in full screen until the next image is entirely decoded into memory, the result is a smoother transition between images.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Disable screen saver</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- This option will execute\r
- <emphasis role="i">xscreensaver-command --deactivate</emphasis>\r
- once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOptionsWindow">
+ <title>Window Options</title>
+ <para>This section describes the options presented under the Windows Tab of the preferences dialog.</para>
+ <section id="State">
+ <title>State</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Remember session</guilabel>
+ </term>
+ <listitem>
+ <para>This will maintain windows size and position between Geeqie sessions.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Use saved window positions also for new windows</guilabel>
+ </term>
+ <listitem>
+ <para>
+ A new window opened by menu
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>N</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>New Window</guimenuitem>
+ </menuchoice>
+ will use the saved window positions also.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Remember window workspace</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Remember which workspace a window was displayed in.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Remember tool state</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Maintains the selection set by
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>L</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>File and Folders</guimenuitem>
+ <guimenuitem>Float File List</guimenuitem>
+ </menuchoice>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Remember dialog window positions</guilabel>
+ </term>
+ <listitem>
+ <para>This will maintain dialog windows size and position between Geeqie sessions.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Show window IDs</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Show the window ID in the titlebar of each window. When multiple Geeqie windows are opened, this option shows a unique identifier for each window. It may be used in conjunction with the command line option:
+ <link linkend="Remotecommands">
+ <programlisting>--remote --id:<ID></programlisting>
+ </link>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Use current layout for default</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Press the <code>Set</code> button to store the current window layout for use as the default for all new windows.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Size">
+ <title>Size</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Fit window to image when tools are hidden/floating</guilabel>
+ </term>
+ <listitem>
+ <para>The main window will be resized to accommodate each image's size and proportions when the image pane is the only one visible within the window.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Limit size when auto-sizing window</guilabel>
+ </term>
+ <listitem>
+ <para>This will restrict the maximum size a window can grow to automatically fit an image. The value represents the percentage of the desktop size in width and height.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="FullScreen">
+ <title>Full Screen</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Location</guilabel>
+ </term>
+ <listitem>
+ <para>Selects the location and position of the full screen window. 'Determined by window manager' will leave the window placement up to the window manager. 'Active screen' places the window on the same screen as the Geeqie main window. 'Active monitor' does the same, but limits the full screen window size to the monitor containing the main window. The remaining choices are dependent on the multiple monitor configuration.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Smooth image flip</guilabel>
+ </term>
+ <listitem>
+ <para>This option delays the image change in full screen until the next image is entirely decoded into memory, the result is a smoother transition between images.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Disable screen saver</guilabel>
+ </term>
+ <listitem>
+ <para>
+ This option will execute
+ <emphasis role="i">xscreensaver-command --deactivate</emphasis>
+ once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideOtherSoftware">\r
- <title id="titleGuideOtherSoftware">Useful Software</title>\r
- <para>This is a list of other software that users might find useful in conjunction with Geeqie.</para>\r
- <section id="OtherSoftware">\r
- <section id="Entangle">\r
- <title>Entangle</title>\r
- <para>\r
- Tethered photography:\r
- <ulink url="https://entangle-photo.org/">https://entangle-photo.org/</ulink>\r
- </para>\r
- </section>\r
- <section id="Photini">\r
- <title>Photini</title>\r
- <para>\r
- Digital photograph metadata editor:\r
- <ulink url="https://photini.readthedocs.io/en/latest/">https://photini.readthedocs.io/en/latest/</ulink>\r
- </para>\r
- </section>\r
- <section id="Unison">\r
- <title>Unison</title>\r
- <para>\r
- Unison allows two replicas of a collection of files and directories to be stored on different hosts (or different disks on the same host), modified separately, and then brought up to date by propagating the changes in each replica to the other (n.b. there is a GTK GUI .deb package):\r
- <ulink url="https://www.cis.upenn.edu/~bcpierce/unison/">https://www.cis.upenn.edu/~bcpierce/unison/</ulink>\r
- </para>\r
- </section>\r
- <section id="GeeqieCacheMaintenance">\r
- <title>Geeqie Cache Maintenance</title>\r
- <para>\r
- Command line program to automatically create or update thumbnails and similarity data: <link linkend="CacheMaintenance"><code>geeqie-cache-maintenance</code></link>\r
- </para>\r
- </section>\r
- <section id="KeywordMerge">\r
- <title>Keyword Merge</title>\r
- <para>\r
- This program will merge the keyword tree of one Geeqie configuration file into another. The keyword trees are simply concatenated. When Geeqie loads the resulting configuration file, any duplicates are discarded: <ulink url="https://raw.githubusercontent.com/BestImageViewer/geeqie/master/scripts/keyword_merge.sh">keyword_merge.sh</ulink>\r
- </para>\r
- </section>\r
- <section id="InstallDebian">\r
- <title>Install Geeqie from sources on Debian</title>\r
- <para>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideOtherSoftware">
+ <title id="titleGuideOtherSoftware">Useful Software</title>
+ <para>This is a list of other software that users might find useful in conjunction with Geeqie.</para>
+ <section id="OtherSoftware">
+ <section id="Entangle">
+ <title>Entangle</title>
+ <para>
+ Tethered photography:
+ <ulink url="https://entangle-photo.org/">https://entangle-photo.org/</ulink>
+ </para>
+ </section>
+ <section id="Photini">
+ <title>Photini</title>
+ <para>
+ Digital photograph metadata editor:
+ <ulink url="https://photini.readthedocs.io/en/latest/">https://photini.readthedocs.io/en/latest/</ulink>
+ </para>
+ </section>
+ <section id="Unison">
+ <title>Unison</title>
+ <para>
+ Unison allows two replicas of a collection of files and directories to be stored on different hosts (or different disks on the same host), modified separately, and then brought up to date by propagating the changes in each replica to the other (n.b. there is a GTK GUI .deb package):
+ <ulink url="https://www.cis.upenn.edu/~bcpierce/unison/">https://www.cis.upenn.edu/~bcpierce/unison/</ulink>
+ </para>
+ </section>
+ <section id="GeeqieCacheMaintenance">
+ <title>Geeqie Cache Maintenance</title>
+ <para>
+ Command line program to automatically create or update thumbnails and similarity data: <link linkend="CacheMaintenance"><code>geeqie-cache-maintenance</code></link>
+ </para>
+ </section>
+ <section id="KeywordMerge">
+ <title>Keyword Merge</title>
+ <para>
+ This program will merge the keyword tree of one Geeqie configuration file into another. The keyword trees are simply concatenated. When Geeqie loads the resulting configuration file, any duplicates are discarded: <ulink url="https://raw.githubusercontent.com/BestImageViewer/geeqie/master/scripts/keyword_merge.sh">keyword_merge.sh</ulink>
+ </para>
+ </section>
+ <section id="InstallDebian">
+ <title>Install Geeqie from sources on Debian</title>
+ <para>
This script will clone the Geeqie repository, fulfill all dependencies, and install Geeqie on a Debian based system: <ulink url="https://raw.githubusercontent.com/BestImageViewer/geeqie/master/web/geeqie-install-debian.sh">geeqie-install-debian.sh</ulink>
- </para>\r
- </section>\r
- <section id="GenericInstall">\r
- <title>Generic install script</title>\r
- <para>\r
- This script will install Geeqie to a defined location, and will run under any system. However, it is left to you to make sure dependencies are fulfilled: <ulink url="https://raw.githubusercontent.com/pixlsus/Scripts/master/build-geeqie">build-geeqie</ulink>\r
- </para>\r
- </section>\r
- <section id="DecodeSim">\r
- <title>Decoder for .sim files</title>\r
- <para>\r
- This program is unlikely to be of interest to most users. It shows a summary of the contents of a .sim file. (Requires perl to be installed): <ulink url="https://raw.githubusercontent.com/BestImageViewer/geeqie/master/scripts/decode_sim">decode_sim</ulink>\r
- </para>\r
- </section>\r
- </section>\r
-</chapter>\r
+ </para>
+ </section>
+ <section id="GenericInstall">
+ <title>Generic install script</title>
+ <para>
+ This script will install Geeqie to a defined location, and will run under any system. However, it is left to you to make sure dependencies are fulfilled: <ulink url="https://raw.githubusercontent.com/pixlsus/Scripts/master/build-geeqie">build-geeqie</ulink>
+ </para>
+ </section>
+ <section id="DecodeSim">
+ <title>Decoder for .sim files</title>
+ <para>
+ This program is unlikely to be of interest to most users. It shows a summary of the contents of a .sim file. (Requires perl to be installed): <ulink url="https://raw.githubusercontent.com/BestImageViewer/geeqie/master/scripts/decode_sim">decode_sim</ulink>
+ </para>
+ </section>
+ </section>
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideOtherWindows">\r
- <title id="titleGuideOtherWindows">Stand-alone Windows</title>\r
- <para>\r
- This section describes the windows that may be displayed simultaneously with the Geeqie main window. They are initiated via the\r
- <emphasis role="bold">View</emphasis>\r
- and\r
- <emphasis role="bold">File</emphasis>\r
- menus.\r
- </para>\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherWindowsImageWindow.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherWindowsExif.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherWindowsPanView.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideCollections.xml" />\r
- <para />\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideOtherWindows">
+ <title id="titleGuideOtherWindows">Stand-alone Windows</title>
+ <para>
+ This section describes the windows that may be displayed simultaneously with the Geeqie main window. They are initiated via the
+ <emphasis role="bold">View</emphasis>
+ and
+ <emphasis role="bold">File</emphasis>
+ menus.
+ </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherWindowsImageWindow.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherWindowsExif.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideOtherWindowsPanView.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideCollections.xml" />
+ <para />
</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOtherWindowsExif">\r
- <title id="titleGuideOtherWindowsExif">Exif Window</title>\r
- <para>The Exif window shows the Exif, IPTC and XMP metadata that are present in the image file.</para>\r
- <para>Unlike the other parts of the program, this window shows the "raw" metadata read from the file, without any post-processing. Thus, this window is ideal for metadata debugging.</para>\r
- <para>\r
- The Exif pane in the\r
- <link linkend="GuideSidebarsInfo">Info Sidebar</link>\r
- is more suitable for general use, as it displays merged data from sidecar and private metadata files.\r
- </para>\r
- <para>\r
- To facilitate including extra items in the Exif pane in the\r
- <link linkend="GuideSidebarsInfo">Info Sidebar</link>\r
- , it is possible to drag-and-drop an item from the Exif window onto the Sidebar pane.\r
- </para>\r
- <para />\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOtherWindowsExif">
+ <title id="titleGuideOtherWindowsExif">Exif Window</title>
+ <para>The Exif window shows the Exif, IPTC and XMP metadata that are present in the image file.</para>
+ <para>Unlike the other parts of the program, this window shows the "raw" metadata read from the file, without any post-processing. Thus, this window is ideal for metadata debugging.</para>
+ <para>
+ The Exif pane in the
+ <link linkend="GuideSidebarsInfo">Info Sidebar</link>
+ is more suitable for general use, as it displays merged data from sidecar and private metadata files.
+ </para>
+ <para>
+ To facilitate including extra items in the Exif pane in the
+ <link linkend="GuideSidebarsInfo">Info Sidebar</link>
+ , it is possible to drag-and-drop an item from the Exif window onto the Sidebar pane.
+ </para>
+ <para />
</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOtherWindowsImageWindow">\r
- <title>Image Window</title>\r
- <para>An image window is a window that displays only the image, without menus or sidebars.</para>\r
- <para>An image window can always be opened from the context menu of all images and files. Keyboard shortcuts exist for most windows that display images or files, however the shortcut can vary dependent on the type of window containing them.</para>\r
- <para>\r
- The image pane contained in an image window behaves and operates similar to the\r
- <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />\r
- of a Main Window, including the\r
- <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />\r
- . The keyboard shortcuts are the same, and the context menu is the same except\r
- <emphasis>Hide file list</emphasis>\r
- is replaced by\r
- <emphasis>Close window</emphasis>\r
- . The\r
- <link linkend="GuideImagePresentationSlideshow">slide show</link>\r
- and\r
- <link linkend="GuideImagePresentationFullscreen">full screen</link>\r
- functions are also available.\r
- </para>\r
- <para />\r
- <section id="Navigation">\r
- <title>Navigation</title>\r
- <para>\r
- When the image window is initiated from an image selection or from a collection window, the displayed image can be changed forward or backward in the list with the respective\r
- <keycap>PageDown</keycap>\r
- and\r
- <keycap>PageUp</keycap>\r
- keys. In addition, all navigation methods for the mouse and keyboard are similar to that of the\r
- <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />\r
- of a Main Window.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="ImageWindowDragandDrop">\r
- <title id="titleImageWindowDragandDrop">Drag and Drop</title>\r
- <para>\r
- Images can be dragged and dropped onto an image window, but the process is somewhat different to that of an\r
- <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />\r
- . If multiple images, a folder or an image from a collection window is dropped onto the image window, you can cycle through all these images using the navigation keys.\r
- </para>\r
- <para>The dropped item can be one or more files, folders, or an image from a collection window:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>One or more files</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The image window will display the first image; the list of dropped images can be navigated similar to a main window's image pane.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>One or more folders</guilabel>\r
- </term>\r
- <listitem>\r
- <para>When the dropped list of items includes a folder, a menu will appear allowing to skip the folders, add their contents, or add their contents recursively. After choosing from the menu the requested files will be added to the image window.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Image from a collection</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The image window will change to display the image and become linked to the collection containing the image. Images in the collection can then be navigated and viewed from the image window.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para>Changing the image window by dropping a new item onto it will cause the previous list of images or linked collection to be discarded.</para>\r
- <para>\r
- To update the image display in the event that the source file has changed, press\r
- <keycap>R</keycap>\r
- .\r
- </para>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOtherWindowsImageWindow">
+ <title>Image Window</title>
+ <para>An image window is a window that displays only the image, without menus or sidebars.</para>
+ <para>An image window can always be opened from the context menu of all images and files. Keyboard shortcuts exist for most windows that display images or files, however the shortcut can vary dependent on the type of window containing them.</para>
+ <para>
+ The image pane contained in an image window behaves and operates similar to the
+ <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />
+ of a Main Window, including the
+ <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />
+ . The keyboard shortcuts are the same, and the context menu is the same except
+ <emphasis>Hide file list</emphasis>
+ is replaced by
+ <emphasis>Close window</emphasis>
+ . The
+ <link linkend="GuideImagePresentationSlideshow">slide show</link>
+ and
+ <link linkend="GuideImagePresentationFullscreen">full screen</link>
+ functions are also available.
+ </para>
+ <para />
+ <section id="Navigation">
+ <title>Navigation</title>
+ <para>
+ When the image window is initiated from an image selection or from a collection window, the displayed image can be changed forward or backward in the list with the respective
+ <keycap>PageDown</keycap>
+ and
+ <keycap>PageUp</keycap>
+ keys. In addition, all navigation methods for the mouse and keyboard are similar to that of the
+ <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />
+ of a Main Window.
+ </para>
+ <para />
+ </section>
+ <section id="ImageWindowDragandDrop">
+ <title id="titleImageWindowDragandDrop">Drag and Drop</title>
+ <para>
+ Images can be dragged and dropped onto an image window, but the process is somewhat different to that of an
+ <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />
+ . If multiple images, a folder or an image from a collection window is dropped onto the image window, you can cycle through all these images using the navigation keys.
+ </para>
+ <para>The dropped item can be one or more files, folders, or an image from a collection window:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>One or more files</guilabel>
+ </term>
+ <listitem>
+ <para>The image window will display the first image; the list of dropped images can be navigated similar to a main window's image pane.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>One or more folders</guilabel>
+ </term>
+ <listitem>
+ <para>When the dropped list of items includes a folder, a menu will appear allowing to skip the folders, add their contents, or add their contents recursively. After choosing from the menu the requested files will be added to the image window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Image from a collection</guilabel>
+ </term>
+ <listitem>
+ <para>The image window will change to display the image and become linked to the collection containing the image. Images in the collection can then be navigated and viewed from the image window.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para>Changing the image window by dropping a new item onto it will cause the previous list of images or linked collection to be discarded.</para>
+ <para>
+ To update the image display in the event that the source file has changed, press
+ <keycap>R</keycap>
+ .
+ </para>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideOtherWindowsPanView">\r
- <title>Pan View</title>\r
- <para>\r
- This window offers alternative views of the\r
- <emphasis role="i">current directory and its children</emphasis>\r
- .\r
- <para />\r
- It may be opened by\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>J</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>View</guimenu>\r
- <guimenuitem>Pan view</guimenuitem>\r
- </menuchoice>\r
- .\r
- \r
- You can pan the view as you pan an image in normal view mode, using left mouse button and drag.\r
- </para>\r
- <para>A primary mouse button click on any image will display information about the image. Secondary mouse button will show a context menu.</para>\r
- <para>\r
- The\r
- <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />\r
- available are listed in the Reference section.\r
- </para>\r
- <note>\r
- <para>Pan view recursively visits each folder under the specified folder. This can consume considerable computer resources.</para>\r
- </note>\r
- <para />\r
- <section id="Selectafolder">\r
- <title>Select a folder</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Location</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The initial location is the current Geeqie folder when the Pan view window is opened.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Chooseaviewmode">\r
- <title>Choose a view mode</title>\r
- <para>A select box let you choose among different view modes:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Timeline</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Shows images grouped by date.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Calendar</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Shows a calendar with the number of images indicated for each day (as dots and number). Left mouse button click will show images in a pop-up.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Folders</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Show images grouped by folder. Each box represents a folder. Parent and children folders are shown as boxes enclosing other boxes.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Folders (flower)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Show images grouped by folder. Each box represents a folder. Parent folders are linked to children by a line. The top folder is the center of the flower.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Grid</guilabel>\r
- </term>\r
- <listitem>\r
- <para>All images are shown on a grid.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Howeachimageshouldberepresented">\r
- <title>How each image should be represented</title>\r
- <para>Another select box let you choose the representation of each image:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Dots</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by a dot.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>No images</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by a square box.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Small thumbnails</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by a small thumbnail.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Normal thumbnails</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by a normal thumbnail.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Large thumbnails</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by a large thumbnail.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>1:10 (10%)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by reduced image (1/10 of the original's dimensions).</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>1:4 (25%)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by reduced image (1/4 of the original's dimensions).</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>1:3 (33%)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by reduced image (1/3 of the original's dimensions).</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>1:2 (50%)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Each image is represented by reduced image (1/2 of the original's dimensions).</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>1:1 (100%)</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The original image is shown at its normal dimensions.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Find">\r
- <title>Find</title>\r
- <para>At the bottom of the window:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Find button</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Shows a text field for image search. One can enter either:\r
- <itemizedlist>\r
- <listitem>filename or part filename</listitem>\r
- <listitem>\r
- file date in any of the following forms, where the separator may one of\r
- <code>/</code>\r
- <code>-</code>\r
- <code>,</code>\r
- <code>.</code>\r
- or a space:\r
- <itemizedlist>\r
- <listitem>yyyy-mm-dd</listitem>\r
- <listitem>yyyy-mm</listitem>\r
- <listitem>yyyy</listitem>\r
- </itemizedlist>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- <keycap>Enter</keycap>\r
- will start the search, pressing it again will move to the next match. The matched file is made visible and details are shown for it.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideOtherWindowsPanView">
+ <title>Pan View</title>
+ <para>
+ This window offers alternative views of the
+ <emphasis role="i">current directory and its children</emphasis>
+ .
+ <para />
+ It may be opened by
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>J</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>Pan view</guimenuitem>
+ </menuchoice>
+ .
+
+ You can pan the view as you pan an image in normal view mode, using left mouse button and drag.
+ </para>
+ <para>A primary mouse button click on any image will display information about the image. Secondary mouse button will show a context menu.</para>
+ <para>
+ The
+ <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />
+ available are listed in the Reference section.
+ </para>
+ <note>
+ <para>Pan view recursively visits each folder under the specified folder. This can consume considerable computer resources.</para>
+ </note>
+ <para />
+ <section id="Selectafolder">
+ <title>Select a folder</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Location</guilabel>
+ </term>
+ <listitem>
+ <para>The initial location is the current Geeqie folder when the Pan view window is opened.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Chooseaviewmode">
+ <title>Choose a view mode</title>
+ <para>A select box let you choose among different view modes:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Timeline</guilabel>
+ </term>
+ <listitem>
+ <para>Shows images grouped by date.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Calendar</guilabel>
+ </term>
+ <listitem>
+ <para>Shows a calendar with the number of images indicated for each day (as dots and number). Left mouse button click will show images in a pop-up.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Folders</guilabel>
+ </term>
+ <listitem>
+ <para>Show images grouped by folder. Each box represents a folder. Parent and children folders are shown as boxes enclosing other boxes.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Folders (flower)</guilabel>
+ </term>
+ <listitem>
+ <para>Show images grouped by folder. Each box represents a folder. Parent folders are linked to children by a line. The top folder is the center of the flower.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Grid</guilabel>
+ </term>
+ <listitem>
+ <para>All images are shown on a grid.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Howeachimageshouldberepresented">
+ <title>How each image should be represented</title>
+ <para>Another select box let you choose the representation of each image:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Dots</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by a dot.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>No images</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by a square box.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Small thumbnails</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by a small thumbnail.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Normal thumbnails</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by a normal thumbnail.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Large thumbnails</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by a large thumbnail.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>1:10 (10%)</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by reduced image (1/10 of the original's dimensions).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>1:4 (25%)</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by reduced image (1/4 of the original's dimensions).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>1:3 (33%)</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by reduced image (1/3 of the original's dimensions).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>1:2 (50%)</guilabel>
+ </term>
+ <listitem>
+ <para>Each image is represented by reduced image (1/2 of the original's dimensions).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>1:1 (100%)</guilabel>
+ </term>
+ <listitem>
+ <para>The original image is shown at its normal dimensions.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Find">
+ <title>Find</title>
+ <para>At the bottom of the window:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Find button</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Shows a text field for image search. One can enter either:
+ <itemizedlist>
+ <listitem>filename or part filename</listitem>
+ <listitem>
+ file date in any of the following forms, where the separator may one of
+ <code>/</code>
+ <code>-</code>
+ <code>,</code>
+ <code>.</code>
+ or a space:
+ <itemizedlist>
+ <listitem>yyyy-mm-dd</listitem>
+ <listitem>yyyy-mm</listitem>
+ <listitem>yyyy</listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ <para />
+ <keycap>Enter</keycap>
+ will start the search, pressing it again will move to the next match. The matched file is made visible and details are shown for it.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuidePluginsConfig">\r
- <title id="titleGuidePluginsConfig">Plugins Configuration</title>\r
- <para />\r
- <section id="PluginsConfigurationDialog">\r
- <title>Plugins Configuration Dialog</title>\r
- <para>\r
- This dialog allows user to add new plugins or modify the system ones. It is available in the menu\r
- <menuchoice>\r
- <guimenu>Edit</guimenu>\r
- <guimenuitem>Configure Plugins</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <para>\r
- The Plugins dialog shows list of all relevant plugins i.e. all installed desktop files that are designated either:\r
- <itemizedlist spacing="compact">\r
- >\r
- <listitem>\r
- <literal>Categories=Graphics</literal>\r
- </listitem>\r
- <listitem>\r
- <literal>Categories=X-Geeqie</literal>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- The list has the following columns:\r
- </para>\r
- <variablelist spacing="compact">\r
- <varlistentry>\r
- <term>\r
- <guilabel>Disabled</guilabel>\r
- </term>\r
- <listitem>\r
- <para>If the checkbox is ticked, the plugin will not be displayed in Geeqie menus.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Name</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Plugin name as specified in desktop file, and is the name displayed in menus.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Hidden</guilabel>\r
- </term>\r
- <listitem>\r
- A plugin can be\r
- <emphasis>Hidden</emphasis>\r
- for one of these reasons:\r
- <itemizedlist>\r
- <listitem>\r
- the desktop file contains\r
- <literal>Hidden=TRUE</literal>\r
- or\r
- <literal>NoDisplay=TRUE</literal>\r
- </listitem>\r
- <listitem>\r
- <literal>TryExec</literal>\r
- binary was not found\r
- </listitem>\r
- <listitem>\r
- <literal>MimeType</literal>\r
- list does not contain images\r
- </listitem>\r
- <listitem>\r
- <literal>MimeType</literal>\r
- list is empty and\r
- <literal>Categories</literal>\r
- does not contain\r
- <literal>X-Geeqie</literal>\r
- </listitem>\r
- </itemizedlist>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist spacing="compact">\r
- <varlistentry>\r
- <term>\r
- <guilabel>Desktop file</guilabel>\r
- </term>\r
- <listitem>\r
- Name of the desktop file, used as an identifier in\r
- <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />\r
- .\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Path</guilabel>\r
- </term>\r
- <listitem>Full path to the desktop file. Desktop files in user directories override the system ones with the same name.</listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Addingnewplugin">\r
- <title>Adding new plugin</title>\r
- <para>\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="document-new.png" />\r
- </guiicon>\r
- New\r
- </guibutton>\r
- </code>\r
- opens a text editor with a desktop file template. You must amend the line\r
- <programlisting>Exec=command %f</programlisting>\r
- to contain the command you wish to execute. If it is more than a single command, you must create a script file and call that. If the location of the script file is not in your $PATH environment variable, you must include the full pathname.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Modifyinganexistingplugin">\r
- <title>Modifying an existing plugin</title>\r
- <para>\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="gtk-edit.png" />\r
- </guiicon>\r
- Edit\r
- </guibutton>\r
- </code>\r
- opens a text editor with existing desktop file. For desktop files that are not writable by user, it allows saving to a Geeqie specific directory, where it overrides the system file (but only for Geeqie).\r
- </para>\r
- </section>\r
- <section id="Deletingaplugin">\r
- <title>Deleting a plugin</title>\r
- <para>\r
- <code>\r
- <guibutton>\r
- <guiicon>\r
- <inlinegraphic fileref="edit-delete.png" />\r
- </guiicon>\r
- Delete\r
- </guibutton>\r
- </code>\r
- can delete user writable desktop files. System desktop files can't be deleted directly, but it is possible to edit them and set\r
- <literal>Hidden=TRUE</literal>\r
- , see above.\r
- </para>\r
- </section>\r
- <section id="Specialplugins">\r
- <title>Special plugins</title>\r
- <para>A desktop file with one of the following names has a special function. It will replace the corresponding internal command.</para>\r
- <para>\r
- <programlisting xml:space="preserve">\r
- geeqie-copy-command.desktop\r
- geeqie-move-command.desktop\r
- geeqie-rename-command.desktop\r
- geeqie-delete-command.desktop\r
- geeqie-folder-command.desktop\r
- </programlisting>\r
- </para>\r
- <para>This can be used for example for a custom trash command or for manipulation of files under version control.</para>\r
- </section>\r
- <section id="Geeqieextensions">\r
- <title>Geeqie desktop file keys</title>\r
- <para>\r
- A desktop file for use only by Geeqie should have the following entries:\r
- <programlisting>\r
- Categories=X-Geeqie;\r
- OnlyShowIn=X-Geeqie;\r
- </programlisting>\r
- </para>\r
- <para>\r
- A menu path where the plugin will appear, instead of in the default\r
- <menuchoice>\r
- <guimenu>Plugins</guimenu>\r
- </menuchoice>\r
- , can be set by including:\r
- <programlisting>X-Geeqie-Menu-Path=<FileMenuPath></programlisting>\r
- </para>\r
- <para>\r
- Possible vales for\r
- <emphasis>FileMenuPath</emphasis>\r
- are:\r
- <programlisting xml:space="preserve">\r
- FileMenu\r
- FileMenu/OpenSection\r
- FileMenu/SearchSection\r
- FileMenu/PrintSection\r
- FileMenu/FileOpsSection\r
- FileMenu/QuitSection\r
- GoMenu\r
- SelectMenu\r
- SelectMenu/SelectSection\r
- SelectMenu/ClipboardSection\r
- SelectMenu/MarksSection\r
- EditMenu/EditMenu\r
- EditMenu/EditSection\r
- EditMenu/OrientationMenu\r
- EditMenu/RatingMenu\r
- EditMenu/PropertiesSection\r
- EditMenu/PreferencesSection\r
- PluginsMenu\r
- ViewMenu\r
- ViewMenu/WindowSection\r
- ViewMenu/FileDirMenu\r
- ViewMenu/FileDirMenu/FolderSection\r
- ViewMenu/FileDirMenu/ListSection\r
- ViewMenu/DirSection\r
- ViewMenu/ZoomMenu\r
- ViewMenu/ZoomMenu/ConnectZoomMenu\r
- ViewMenu/SplitMenu\r
- ViewMenu/StereoMenu\r
- ViewMenu/ColorMenu\r
- ViewMenu/OverlayMenu\r
- ViewMenu/ViewSection\r
- ViewMenu/ToolsSection\r
- ViewMenu/SlideShowSection\r
- HelpMenu\r
- HelpMenu/HelpSection\r
- </programlisting>\r
- </para>\r
- <para>\r
- If you want a plugin to use a user-definable path, the following entry must be made in the desktop file:\r
- <programlisting>X-Geeqie-Filter=true</programlisting>\r
- </para>\r
- <para>\r
- Desktop files containing this entry will be displayed in the Folder action list of the\r
- <link linkend="CopyMoveandLink" endterm="titleGuideSidebarsSortManager" />\r
- . The path of the bookmark clicked will be used by the desktop file.\r
- <para />\r
- If the desktop file is called from the menu, when the plugin is executed you are presented with a dialogue which enables a path to be selected. The path selected, appended by the filename currently being processed, is made available to the shell script either as an environment variable or via a call to geeqie --remote. The following code demonstrates the use of both methods:\r
- <programlisting xml:space="preserve">\r
- for file in "$@"\r
- do\r
- destination=$(geeqie --remote --get-destination:"$file")\r
- \r
- echo "$destination"\r
- echo $GEEQIE_DESTINATION\r
- done\r
- </programlisting>\r
- </para>\r
- <para>\r
- If you want to run a plugin in full-screen mode and wish full-screen to be maintained, include the following entry in the desktop file:\r
- <programlisting>X-Geeqie-Keep-Fullscreen=true</programlisting>\r
- </para>\r
- <para>\r
- Any terminal output from the plugin command can be displayed with the following command:\r
- <programlisting>X-Geeqie-Verbose=true</programlisting>\r
- </para>\r
- <para>\r
- Any terminal output from the plugin command can be displayed, only when multiple files are selected, with the following command:\r
- <programlisting>X-Geeqie-Verbose-Multi=true</programlisting>\r
- </para>\r
- <para>\r
- The plugin can be restricted to run on only certain file types, for example:\r
- <programlisting>X-Geeqie-File-Extensions=.jpg; .cr2</programlisting>\r
- The entries are case insensitive.\r
- </para>\r
- <para>\r
- The key or key combination to execute this function can be set with:\r
- <programlisting>X-Geeqie-Hotkey=</programlisting>\r
- Key combinations are of the form:\r
-\r
- <programlisting>X-Geeqie-Hotkey=<control>y</programlisting>\r
- <note>\r
- This value may conflict with a setting in\r
- <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />\r
- </note>\r
- </para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuidePluginsConfig">
+ <title id="titleGuidePluginsConfig">Plugins Configuration</title>
+ <para />
+ <section id="PluginsConfigurationDialog">
+ <title>Plugins Configuration Dialog</title>
+ <para>
+ This dialog allows user to add new plugins or modify the system ones. It is available in the menu
+ <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Configure Plugins</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <para>
+ The Plugins dialog shows list of all relevant plugins i.e. all installed desktop files that are designated either:
+ <itemizedlist spacing="compact">
+ >
+ <listitem>
+ <literal>Categories=Graphics</literal>
+ </listitem>
+ <listitem>
+ <literal>Categories=X-Geeqie</literal>
+ </listitem>
+ </itemizedlist>
+ <para />
+ The list has the following columns:
+ </para>
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term>
+ <guilabel>Disabled</guilabel>
+ </term>
+ <listitem>
+ <para>If the checkbox is ticked, the plugin will not be displayed in Geeqie menus.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Name</guilabel>
+ </term>
+ <listitem>
+ <para>Plugin name as specified in desktop file, and is the name displayed in menus.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Hidden</guilabel>
+ </term>
+ <listitem>
+ A plugin can be
+ <emphasis>Hidden</emphasis>
+ for one of these reasons:
+ <itemizedlist>
+ <listitem>
+ the desktop file contains
+ <literal>Hidden=TRUE</literal>
+ or
+ <literal>NoDisplay=TRUE</literal>
+ </listitem>
+ <listitem>
+ <literal>TryExec</literal>
+ binary was not found
+ </listitem>
+ <listitem>
+ <literal>MimeType</literal>
+ list does not contain images
+ </listitem>
+ <listitem>
+ <literal>MimeType</literal>
+ list is empty and
+ <literal>Categories</literal>
+ does not contain
+ <literal>X-Geeqie</literal>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term>
+ <guilabel>Desktop file</guilabel>
+ </term>
+ <listitem>
+ Name of the desktop file, used as an identifier in
+ <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />
+ .
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Path</guilabel>
+ </term>
+ <listitem>Full path to the desktop file. Desktop files in user directories override the system ones with the same name.</listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Addingnewplugin">
+ <title>Adding new plugin</title>
+ <para>
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="document-new.png" />
+ </guiicon>
+ New
+ </guibutton>
+ </code>
+ opens a text editor with a desktop file template. You must amend the line
+ <programlisting>Exec=command %f</programlisting>
+ to contain the command you wish to execute. If it is more than a single command, you must create a script file and call that. If the location of the script file is not in your $PATH environment variable, you must include the full pathname.
+ </para>
+ <para />
+ </section>
+ <section id="Modifyinganexistingplugin">
+ <title>Modifying an existing plugin</title>
+ <para>
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="gtk-edit.png" />
+ </guiicon>
+ Edit
+ </guibutton>
+ </code>
+ opens a text editor with existing desktop file. For desktop files that are not writable by user, it allows saving to a Geeqie specific directory, where it overrides the system file (but only for Geeqie).
+ </para>
+ </section>
+ <section id="Deletingaplugin">
+ <title>Deleting a plugin</title>
+ <para>
+ <code>
+ <guibutton>
+ <guiicon>
+ <inlinegraphic fileref="edit-delete.png" />
+ </guiicon>
+ Delete
+ </guibutton>
+ </code>
+ can delete user writable desktop files. System desktop files can't be deleted directly, but it is possible to edit them and set
+ <literal>Hidden=TRUE</literal>
+ , see above.
+ </para>
+ </section>
+ <section id="Specialplugins">
+ <title>Special plugins</title>
+ <para>A desktop file with one of the following names has a special function. It will replace the corresponding internal command.</para>
+ <para>
+ <programlisting xml:space="preserve">
+ geeqie-copy-command.desktop
+ geeqie-move-command.desktop
+ geeqie-rename-command.desktop
+ geeqie-delete-command.desktop
+ geeqie-folder-command.desktop
+ </programlisting>
+ </para>
+ <para>This can be used for example for a custom trash command or for manipulation of files under version control.</para>
+ </section>
+ <section id="Geeqieextensions">
+ <title>Geeqie desktop file keys</title>
+ <para>
+ A desktop file for use only by Geeqie should have the following entries:
+ <programlisting>
+ Categories=X-Geeqie;
+ OnlyShowIn=X-Geeqie;
+ </programlisting>
+ </para>
+ <para>
+ A menu path where the plugin will appear, instead of in the default
+ <menuchoice>
+ <guimenu>Plugins</guimenu>
+ </menuchoice>
+ , can be set by including:
+ <programlisting>X-Geeqie-Menu-Path=<FileMenuPath></programlisting>
+ </para>
+ <para>
+ Possible vales for
+ <emphasis>FileMenuPath</emphasis>
+ are:
+ <programlisting xml:space="preserve">
+ FileMenu
+ FileMenu/OpenSection
+ FileMenu/SearchSection
+ FileMenu/PrintSection
+ FileMenu/FileOpsSection
+ FileMenu/QuitSection
+ GoMenu
+ SelectMenu
+ SelectMenu/SelectSection
+ SelectMenu/ClipboardSection
+ SelectMenu/MarksSection
+ EditMenu/EditMenu
+ EditMenu/EditSection
+ EditMenu/OrientationMenu
+ EditMenu/RatingMenu
+ EditMenu/PropertiesSection
+ EditMenu/PreferencesSection
+ PluginsMenu
+ ViewMenu
+ ViewMenu/WindowSection
+ ViewMenu/FileDirMenu
+ ViewMenu/FileDirMenu/FolderSection
+ ViewMenu/FileDirMenu/ListSection
+ ViewMenu/DirSection
+ ViewMenu/ZoomMenu
+ ViewMenu/ZoomMenu/ConnectZoomMenu
+ ViewMenu/SplitMenu
+ ViewMenu/StereoMenu
+ ViewMenu/ColorMenu
+ ViewMenu/OverlayMenu
+ ViewMenu/ViewSection
+ ViewMenu/ToolsSection
+ ViewMenu/SlideShowSection
+ HelpMenu
+ HelpMenu/HelpSection
+ </programlisting>
+ </para>
+ <para>
+ If you want a plugin to use a user-definable path, the following entry must be made in the desktop file:
+ <programlisting>X-Geeqie-Filter=true</programlisting>
+ </para>
+ <para>
+ Desktop files containing this entry will be displayed in the Folder action list of the
+ <link linkend="CopyMoveandLink" endterm="titleGuideSidebarsSortManager" />
+ . The path of the bookmark clicked will be used by the desktop file.
+ <para />
+ If the desktop file is called from the menu, when the plugin is executed you are presented with a dialogue which enables a path to be selected. The path selected, appended by the filename currently being processed, is made available to the shell script either as an environment variable or via a call to geeqie --remote. The following code demonstrates the use of both methods:
+ <programlisting xml:space="preserve">
+ for file in "$@"
+ do
+ destination=$(geeqie --remote --get-destination:"$file")
+
+ echo "$destination"
+ echo $GEEQIE_DESTINATION
+ done
+ </programlisting>
+ </para>
+ <para>
+ If you want to run a plugin in full-screen mode and wish full-screen to be maintained, include the following entry in the desktop file:
+ <programlisting>X-Geeqie-Keep-Fullscreen=true</programlisting>
+ </para>
+ <para>
+ Any terminal output from the plugin command can be displayed with the following command:
+ <programlisting>X-Geeqie-Verbose=true</programlisting>
+ </para>
+ <para>
+ Any terminal output from the plugin command can be displayed, only when multiple files are selected, with the following command:
+ <programlisting>X-Geeqie-Verbose-Multi=true</programlisting>
+ </para>
+ <para>
+ The plugin can be restricted to run on only certain file types, for example:
+ <programlisting>X-Geeqie-File-Extensions=.jpg; .cr2</programlisting>
+ The entries are case insensitive.
+ </para>
+ <para>
+ The key or key combination to execute this function can be set with:
+ <programlisting>X-Geeqie-Hotkey=</programlisting>
+ Key combinations are of the form:
+
+ <programlisting>X-Geeqie-Hotkey=<control>y</programlisting>
+ <note>
+ This value may conflict with a setting in
+ <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />
+ </note>
+ </para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuidePrinting">\r
- <title>Printing</title>\r
- <para>\r
- To print an image select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>P</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>File</guimenu>\r
- <guimenuitem>Print</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <para>The print dialog includes tabs that group related printing options, a preview pane, and a Print and Cancel button.</para>\r
- <section id="Layouttab">\r
- <title>Layout tab</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Source</guilabel>\r
- </term>\r
- <listitem>\r
- <para>This selects the group of images to use for print output.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Image</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The file with the focus.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Selection</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The files selected in the main window.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>All</guilabel>\r
- </term>\r
- <listitem>\r
- <para>All files listed in the main window.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Layout</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Select one image per page, or a Proof sheet that will print multiple images per page.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Image size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>When print one image per page, the size of the image in relation to the available print area.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Proof size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>When printing a Proof sheet, the size of each image in Units (see Paper tab).</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Texttab">\r
- <title>Text tab</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Name</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Include the file name below each image.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Path</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Include the full path of the file below each image.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Date</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Include the file date below each image.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Include the file size below each image.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Dimensions</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Include the source image's pixel width and height below each image.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Font size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The font size to use for the text description of each image, in points.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Papertab">\r
- <title>Paper tab</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Format</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The size of the paper in the printer's paper tray. Many common sizes are provided, however if the paper size is not listed selected the Custom format and enter the paper size in Size below.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Size</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The size of the selected paper format, in Units (below). These numbers can be changed when the paper Format is Custom.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Units</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Select the units for Geeqie to use when conveying measurements of length for paper size, margins, and images sizes to the user.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Orientation</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Select portrait or landscape print output.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Margins</guilabel>\r
- </term>\r
- <listitem>\r
- <para>These values specify the size of the paper edges not to be included in the print region, in Units (above).</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Printertab">\r
- <title>Printer tab</title>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Destination</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Use this to select the destination of the print output.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Default printer</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Prints to the system default printer.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Custom printer</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Prints to the printer using the command defined in Custom printer (below).</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Postscript file</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Writes using the postscript format to named File (below).</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Image file</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Writes using the selected File format (below) to named File (below).</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Custom printer</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The command to use when Destination is selected as Custom printer. For convenience, the drop down list includes printers available for use by the printing subsystem.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>File</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The file to use for output when Destination is Postscript file or Image file.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>File format</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The image format to use when Destination is Image file.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>DPI</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Abbreviation for Dots Per Inch. When the Destination is a printer or postscript file, this defines the maximum DPI to use when outputting image data. For example if the Destination printer is only capable of 600 DPI, but the resulting image to print is 1200 DPI, Geeqie will scale the image down to 600 DPI before sending it to the printer. This can greatly reduce the size of a print job when printing Proof Sheets or very large images.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Preview">\r
- <title>Preview</title>\r
- <para>The preview displays a small version of the output that will result with the current settings. The preview will update whenever a setting is changed that will effect the print output.</para>\r
- <para>The preview will indicate the number of pages that will be printed, to see a preview of a specific page change to that page by activating the left or right arrow buttons located below the preview.</para>\r
- <para>The size of the preview can be changed using the three zoom buttons located below the preview.</para>\r
- <para>\r
- The preview includes several reference lines that are\r
- <emphasis role="i">not included</emphasis>\r
- in the final print:\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Reference grid</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Light gray lines that form a grid over the entire page, the spacing between these lines is dependent on the current measurement unit:</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Inch</guilabel>\r
- </term>\r
- <listitem>\r
- <para>1 inch.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Points</guilabel>\r
- </term>\r
- <listitem>\r
- <para>72 points.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Centimeters or Millimeters</guilabel>\r
- </term>\r
- <listitem>\r
- <para>1 centimeter.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Margins</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Blue lines along each edge of the page represent the location of the print margins, the non-printable area of the page is also gray.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Proof sheet grid</guilabel>\r
- </term>\r
- <listitem>\r
- <para>When the layout is set to Proof sheet, each proof location is indicated with a red rectangle.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Rememberprintsettings">\r
- <title>Remember print settings</title>\r
- <para>Enable this check box to retain the current settings as the default for the print dialog. This option only retains the settings when a print operation is started by activating the print button. In addition, only the settings relevant to the current print operation will be retained.</para>\r
- </section>\r
- <section id="Printbutton">\r
- <title>Print button</title>\r
- <para>Activate the print button to start the print job, the dialog will change to display the progress as images are sent to the selected print destination.</para>\r
- </section>\r
- <section id="Cancelbutton">\r
- <title>Cancel button</title>\r
- <para>Activate this button to close the print dialog, no printing will be performed.</para>\r
- </section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuidePrinting">
+ <title>Printing</title>
+ <para>
+ To print an image select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>P</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>File</guimenu>
+ <guimenuitem>Print</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <para>The print dialog includes tabs that group related printing options, a preview pane, and a Print and Cancel button.</para>
+ <section id="Layouttab">
+ <title>Layout tab</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Source</guilabel>
+ </term>
+ <listitem>
+ <para>This selects the group of images to use for print output.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Image</guilabel>
+ </term>
+ <listitem>
+ <para>The file with the focus.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Selection</guilabel>
+ </term>
+ <listitem>
+ <para>The files selected in the main window.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>All</guilabel>
+ </term>
+ <listitem>
+ <para>All files listed in the main window.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Layout</guilabel>
+ </term>
+ <listitem>
+ <para>Select one image per page, or a Proof sheet that will print multiple images per page.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Image size</guilabel>
+ </term>
+ <listitem>
+ <para>When print one image per page, the size of the image in relation to the available print area.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Proof size</guilabel>
+ </term>
+ <listitem>
+ <para>When printing a Proof sheet, the size of each image in Units (see Paper tab).</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Texttab">
+ <title>Text tab</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Name</guilabel>
+ </term>
+ <listitem>
+ <para>Include the file name below each image.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Path</guilabel>
+ </term>
+ <listitem>
+ <para>Include the full path of the file below each image.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Date</guilabel>
+ </term>
+ <listitem>
+ <para>Include the file date below each image.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Size</guilabel>
+ </term>
+ <listitem>
+ <para>Include the file size below each image.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Dimensions</guilabel>
+ </term>
+ <listitem>
+ <para>Include the source image's pixel width and height below each image.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Font size</guilabel>
+ </term>
+ <listitem>
+ <para>The font size to use for the text description of each image, in points.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Papertab">
+ <title>Paper tab</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Format</guilabel>
+ </term>
+ <listitem>
+ <para>The size of the paper in the printer's paper tray. Many common sizes are provided, however if the paper size is not listed selected the Custom format and enter the paper size in Size below.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Size</guilabel>
+ </term>
+ <listitem>
+ <para>The size of the selected paper format, in Units (below). These numbers can be changed when the paper Format is Custom.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Units</guilabel>
+ </term>
+ <listitem>
+ <para>Select the units for Geeqie to use when conveying measurements of length for paper size, margins, and images sizes to the user.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Orientation</guilabel>
+ </term>
+ <listitem>
+ <para>Select portrait or landscape print output.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Margins</guilabel>
+ </term>
+ <listitem>
+ <para>These values specify the size of the paper edges not to be included in the print region, in Units (above).</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Printertab">
+ <title>Printer tab</title>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Destination</guilabel>
+ </term>
+ <listitem>
+ <para>Use this to select the destination of the print output.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Default printer</guilabel>
+ </term>
+ <listitem>
+ <para>Prints to the system default printer.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Custom printer</guilabel>
+ </term>
+ <listitem>
+ <para>Prints to the printer using the command defined in Custom printer (below).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Postscript file</guilabel>
+ </term>
+ <listitem>
+ <para>Writes using the postscript format to named File (below).</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Image file</guilabel>
+ </term>
+ <listitem>
+ <para>Writes using the selected File format (below) to named File (below).</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Custom printer</guilabel>
+ </term>
+ <listitem>
+ <para>The command to use when Destination is selected as Custom printer. For convenience, the drop down list includes printers available for use by the printing subsystem.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>File</guilabel>
+ </term>
+ <listitem>
+ <para>The file to use for output when Destination is Postscript file or Image file.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>File format</guilabel>
+ </term>
+ <listitem>
+ <para>The image format to use when Destination is Image file.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>DPI</guilabel>
+ </term>
+ <listitem>
+ <para>Abbreviation for Dots Per Inch. When the Destination is a printer or postscript file, this defines the maximum DPI to use when outputting image data. For example if the Destination printer is only capable of 600 DPI, but the resulting image to print is 1200 DPI, Geeqie will scale the image down to 600 DPI before sending it to the printer. This can greatly reduce the size of a print job when printing Proof Sheets or very large images.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Preview">
+ <title>Preview</title>
+ <para>The preview displays a small version of the output that will result with the current settings. The preview will update whenever a setting is changed that will effect the print output.</para>
+ <para>The preview will indicate the number of pages that will be printed, to see a preview of a specific page change to that page by activating the left or right arrow buttons located below the preview.</para>
+ <para>The size of the preview can be changed using the three zoom buttons located below the preview.</para>
+ <para>
+ The preview includes several reference lines that are
+ <emphasis role="i">not included</emphasis>
+ in the final print:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Reference grid</guilabel>
+ </term>
+ <listitem>
+ <para>Light gray lines that form a grid over the entire page, the spacing between these lines is dependent on the current measurement unit:</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Inch</guilabel>
+ </term>
+ <listitem>
+ <para>1 inch.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Points</guilabel>
+ </term>
+ <listitem>
+ <para>72 points.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Centimeters or Millimeters</guilabel>
+ </term>
+ <listitem>
+ <para>1 centimeter.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Margins</guilabel>
+ </term>
+ <listitem>
+ <para>Blue lines along each edge of the page represent the location of the print margins, the non-printable area of the page is also gray.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Proof sheet grid</guilabel>
+ </term>
+ <listitem>
+ <para>When the layout is set to Proof sheet, each proof location is indicated with a red rectangle.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Rememberprintsettings">
+ <title>Remember print settings</title>
+ <para>Enable this check box to retain the current settings as the default for the print dialog. This option only retains the settings when a print operation is started by activating the print button. In addition, only the settings relevant to the current print operation will be retained.</para>
+ </section>
+ <section id="Printbutton">
+ <title>Print button</title>
+ <para>Activate the print button to start the print job, the dialog will change to display the progress as images are sent to the selected print destination.</para>
+ </section>
+ <section id="Cancelbutton">
+ <title>Cancel button</title>
+ <para>Activate this button to close the print dialog, no printing will be performed.</para>
+ </section>
</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideReference">\r
- <title>Reference</title>\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceCommandLine.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceKeyboardShortcuts.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceThumbnails.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceMetadata.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceLua.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceLuaAPI.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceConfig.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceFileDates.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceLIRC.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceTags.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceSupportedFormats.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferencePixbufLoaders.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceStandardPlugins.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceUTC.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceDecodeLatLong.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceStandards.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferencePCRE.xml" />\r
- <para />\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideReference">
+ <title>Reference</title>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceCommandLine.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceKeyboardShortcuts.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceThumbnails.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceMetadata.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceLua.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceLuaAPI.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceConfig.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceFileDates.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceLIRC.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceTags.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceSupportedFormats.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferencePixbufLoaders.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceStandardPlugins.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceUTC.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceDecodeLatLong.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceStandards.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferencePCRE.xml" />
+ <para />
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceCommandLine">\r
- <title>Command Line Options</title>\r
- <para>\r
- Geeqie is called by the command:\r
- <programlisting>\r
- geeqie [options] [path_to_file_or_collection]\r
- <footnote id='ref1'>The name of a collection, with or without either path or extension (.gqv) may be used. If a path is not used and there is a name conflict with a file or folder, that will take precedence.</footnote>\r
- </programlisting>\r
- </para>\r
- <para>You may also use a URL as a filename. The file will be downloaded to a temporary file and displayed.</para>\r
- <para>These are the command line options available to Geeqie:</para>\r
- <table frame="all">\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead rowsep="1" colsep="1">\r
- <row>\r
- <entry>Short Option</entry>\r
- <entry>Long Option</entry>\r
- <entry>Description</entry>\r
- </row>\r
- </thead>\r
- <tbody rowsep="1" colsep="1">\r
- <row>\r
- <entry>+t</entry>\r
- <entry>--with-tools</entry>\r
- <entry>Show file list, menu, and statusbar.</entry>\r
- </row>\r
- <row>\r
- <entry>-t</entry>\r
- <entry>--without-tools</entry>\r
- <entry>Hide file list, menu, and statusbar. Window contains image only.</entry>\r
- </row>\r
- <row>\r
- <entry>-f</entry>\r
- <entry>--fullscreen</entry>\r
- <entry>Start up in fullscreen.</entry>\r
- </row>\r
- <row>\r
- <entry>-s</entry>\r
- <entry>--slideshow</entry>\r
- <entry>Start up in slideshow mode.</entry>\r
- </row>\r
- <row>\r
- <entry>-l [filelist] [collectionlist]</entry>\r
- <entry>--list [filelist] [collectionlist]</entry>\r
- <entry>Open collection window containing images specified on the command line. Any collections on the command line will also be appended to this collection.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--blank</entry>\r
- <entry>Start with file list blank.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--geometry=<w>x<h>+<x>+<y></entry>\r
- <entry>Set the <width> <height> <xoffset> <yoffset> of the window. The parameters are in pixels.</entry>\r
- </row>\r
- <row>\r
- <entry>-n</entry>\r
- <entry>--new-instance</entry>\r
- <entry>Open a new instance of Geeqie.</entry>\r
- </row>\r
- <row>\r
- <entry>-r</entry>\r
- <entry>--remote</entry>\r
- <entry>Send command line options to existing Geeqie process.</entry>\r
- </row>\r
- <row>\r
- <entry>-rh</entry>\r
- <entry>--remote-help</entry>\r
- <entry>List command line options available to --remote.</entry>\r
- </row>\r
- <row>\r
- <entry>-h</entry>\r
- <entry>--help</entry>\r
- <entry>Display brief command line option list.</entry>\r
- </row>\r
- <row>\r
- <entry>-v</entry>\r
- <entry>--version</entry>\r
- <entry>Display version of Geeqie.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--debug[=<level>]</entry>\r
- <entry>Turn on debugging output (when compiled with Debug enabled). <level> is 0 to 4.</entry>\r
- </row>\r
- <row>\r
- <entry>-g:<regexp></entry>\r
- <entry>--grep:<regexp></entry>\r
- <entry>Filter debug output with regular expression</entry>\r
- </row>\r
- <row>\r
- <entry>+w</entry>\r
- <entry>--show-log-window</entry>\r
- <entry>Display log window</entry>\r
- </row>\r
- <row>\r
- <entry>-o:<file></entry>\r
- <entry>--log-file:<file></entry>\r
- <entry>Save log data to file</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--alternate</entry>\r
- <entry>Use alternate similarity algorithm - experimental - requires re-compile.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--disable-clutter</entry>\r
- <entry>Disable use of Clutter library (i.e. GPU accel.). If the Clutter library is compiled into Geeqie but Clutter fails to initialize, it is necessary to start Geeqie with this option.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--cache-maintenance <path></entry>\r
- <entry>\r
- Run cache maintenance\r
- <footnote id='cachemaintenance'>\r
- <para><link linkend="CacheMaintenance">Cache Maintenance</link>.</para>\r
- </footnote>\r
- in non-GUI mode.\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <para />\r
- <section id="Remotecommands">\r
- <title>Remote commands</title>\r
- <para>The --remote command line option will send all entered commands to an existing Geeqie process, a new process will be started if one does not exist. These are the additional commands that can be used with the remote command:</para>\r
- <table frame="all">\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead rowsep="1" colsep="1">\r
- <row>\r
- <entry>Short Option</entry>\r
- <entry>Long Option</entry>\r
- <entry>Description</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>-n</entry>\r
- <entry>--next</entry>\r
- <entry>Change main window to display next image.</entry>\r
- </row>\r
- <row>\r
- <entry>-b</entry>\r
- <entry>--back</entry>\r
- <entry>Change main window to display previous image.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--first</entry>\r
- <entry>Change main window to display first image.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--last</entry>\r
- <entry>Change main window to display last image.</entry>\r
- </row>\r
- <row>\r
- <entry>-f</entry>\r
- <entry>--fullscreen</entry>\r
- <entry>Toggle full screen mode of the main window.</entry>\r
- </row>\r
- <row>\r
- <entry>-fs</entry>\r
- <entry>--fullscreen-start</entry>\r
- <entry>Start full screen mode for main window.</entry>\r
- </row>\r
- <row>\r
- <entry>-fS</entry>\r
- <entry>--fullscreen-stop</entry>\r
- <entry>Stop full screen mode for main window.</entry>\r
- </row>\r
- <row>\r
- <entry>-s</entry>\r
- <entry>--slideshow</entry>\r
- <entry>Toggle slide show for main window.</entry>\r
- </row>\r
- <row>\r
- <entry>-ss</entry>\r
- <entry>--slideshow-start</entry>\r
- <entry>Start slide show for main window.</entry>\r
- </row>\r
- <row>\r
- <entry>-sS</entry>\r
- <entry>--slideshow-stop</entry>\r
- <entry>Stop slide show for main window.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--slideshow-recurse:<folder></entry>\r
- <entry>Start recursive slide show for <folder> in main window.</entry>\r
- </row>\r
- <row>\r
- <entry>-d<[h:][m:][n][.m]></entry>\r
- <entry>--delay=<[h:][m:][n][.m]></entry>\r
- <entry>Set slide show delay to <[hrs:][mins:][n][.m]> seconds, range is 0.1 secs to 24 hours</entry>\r
- </row>\r
- <row>\r
- <entry>+t</entry>\r
- <entry>--tools-show</entry>\r
- <entry>Show tools for main window.</entry>\r
- </row>\r
- <row>\r
- <entry>-t</entry>\r
- <entry>--tools-hide</entry>\r
- <entry>Hide tools for main window.</entry>\r
- </row>\r
- <row>\r
- <entry>-q</entry>\r
- <entry>--quit</entry>\r
- <entry>Quit Geeqie.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--config-load:<file>|layout ID</entry>\r
- <entry>Load configuration from <file>. Use either a full path, or a saved window layout ID.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-sidecars:<file></entry>\r
- <entry>Get list of sidecars of <file>.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-destination:<file></entry>\r
- <entry>Get destination path of <file>. This is used by the symlink desktop file to implement the symbolic link operation. There is no useful function for the user.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>file:<file>|<URL></entry>\r
- <entry>Open <file> or <URL> and bring Geeqie window to the top</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--file:<file>|<URL></entry>\r
- <entry>Open <file> or <URL> and bring Geeqie window to the top</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>File:<file>|<URL></entry>\r
- <entry>Open <file> or <URL> and do not bring Geeqie window to the top</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--File:<file>|<URL></entry>\r
- <entry>Open <file> or <URL> and do not bring Geeqie window to the top</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--tell</entry>\r
- <entry>Print filename [and Collection] of current image</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--pixel-info</entry>\r
- <entry>Print X, Y and RGB of mouse pointer on current image</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-rectangle</entry>\r
- <entry>Get rectangle coordinates</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-render-intent</entry>\r
- <entry>Get render intent</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-filelist:[<FOLDER>]</entry>\r
- <entry>Get list of files and class</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-filelist-recurse:[<FOLDER>]</entry>\r
- <entry>Get list of files and class recursive</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-collection:<COLLECTION></entry>\r
- <entry>Get collection content</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-collection-list</entry>\r
- <entry>Get collection list</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--get-file-info</entry>\r
- <entry>\r
- Get file info\r
- <footnote id='fileinfo'>\r
- <para>File info consists of: class, no. of pages (if multi-page image), (and if exif exists) country name, country code, timezone, local time.</para>\r
- </footnote>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>view:<file></entry>\r
- <entry>Open new window containing <file></entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--view:<file></entry>\r
- <entry>Open new window containing <file></entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--list-clear</entry>\r
- <entry>Clear command line collection list</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--list-add:<file></entry>\r
- <entry>Add <file> to command line collection list</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>raise</entry>\r
- <entry>Bring the geeqie window to the top</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--raise</entry>\r
- <entry>Bring the geeqie window to the top</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--id:<ID></entry>\r
- <entry>\r
- Window ID for following commands\r
- <footnote id='ref3'>\r
- <para>The ID is shown in the titlebar of the window. If multiple windows are open, it can be used to direct commands to a particular window e.g. --remote --id:main --tell</para>\r
- </footnote>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--new-window</entry>\r
- <entry>Open new window</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--close-window</entry>\r
- <entry>Close window</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--geometry=[<w>x<h>][+<x>+<y>]</entry>\r
- <entry>Set the <width> <height> <xoffset> <yoffset> of the window. The parameters are in pixels.</entry>\r
- </row>\r
- <row>\r
- <entry>-ct:clear|clean</entry>\r
- <entry>--cache-thumbs:clear|clean</entry>\r
- <entry>clear or clean thumbnail cache</entry>\r
- </row>\r
- <row>\r
- <entry>-cs:clear|clean</entry>\r
- <entry>--cache-shared:clear|clean</entry>\r
- <entry>clear or clean shared thumbnail cache</entry>\r
- </row>\r
- <row>\r
- <entry>-cm</entry>\r
- <entry>--cache-metadata</entry>\r
- <entry>clean the metadata cache</entry>\r
- </row>\r
- <row>\r
- <entry>-cr:<folder></entry>\r
- <entry>--cache-render:<folder></entry>\r
- <entry>render thumbnails</entry>\r
- </row>\r
- <row>\r
- <entry>-crr:<folder></entry>\r
- <entry>--cache-render-recurse:<folder></entry>\r
- <entry>render thumbnails recursively</entry>\r
- </row>\r
- <row>\r
- <entry>-crs:<folder></entry>\r
- <entry>--cache-render-shared:<folder></entry>\r
- <entry>\r
- render thumbnails\r
- <footnote id='ref2'>\r
- <para>If standard thumbnail cache is not enabled, this command will be ignored.</para>\r
- </footnote>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>-crsr:<folder></entry>\r
- <entry>--cache-render-shared-recurse:<folder></entry>\r
- <entry>render thumbnails recursively</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--lua:<file>,<lua script></entry>\r
- <entry>run lua script on file</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--PWD:<PWD></entry>\r
- <entry>Use PWD as working directory for following commands</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>--print0</entry>\r
- <entry>Terminate returned data with null character instead of newline</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceCommandLine">
+ <title>Command Line Options</title>
+ <para>
+ Geeqie is called by the command:
+ <programlisting>
+ geeqie [options] [path_to_file_or_collection]
+ <footnote id='ref1'>The name of a collection, with or without either path or extension (.gqv) may be used. If a path is not used and there is a name conflict with a file or folder, that will take precedence.</footnote>
+ </programlisting>
+ </para>
+ <para>You may also use a URL as a filename. The file will be downloaded to a temporary file and displayed.</para>
+ <para>These are the command line options available to Geeqie:</para>
+ <table frame="all">
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead rowsep="1" colsep="1">
+ <row>
+ <entry>Short Option</entry>
+ <entry>Long Option</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody rowsep="1" colsep="1">
+ <row>
+ <entry>+t</entry>
+ <entry>--with-tools</entry>
+ <entry>Show file list, menu, and statusbar.</entry>
+ </row>
+ <row>
+ <entry>-t</entry>
+ <entry>--without-tools</entry>
+ <entry>Hide file list, menu, and statusbar. Window contains image only.</entry>
+ </row>
+ <row>
+ <entry>-f</entry>
+ <entry>--fullscreen</entry>
+ <entry>Start up in fullscreen.</entry>
+ </row>
+ <row>
+ <entry>-s</entry>
+ <entry>--slideshow</entry>
+ <entry>Start up in slideshow mode.</entry>
+ </row>
+ <row>
+ <entry>-l [filelist] [collectionlist]</entry>
+ <entry>--list [filelist] [collectionlist]</entry>
+ <entry>Open collection window containing images specified on the command line. Any collections on the command line will also be appended to this collection.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--blank</entry>
+ <entry>Start with file list blank.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--geometry=<w>x<h>+<x>+<y></entry>
+ <entry>Set the <width> <height> <xoffset> <yoffset> of the window. The parameters are in pixels.</entry>
+ </row>
+ <row>
+ <entry>-n</entry>
+ <entry>--new-instance</entry>
+ <entry>Open a new instance of Geeqie.</entry>
+ </row>
+ <row>
+ <entry>-r</entry>
+ <entry>--remote</entry>
+ <entry>Send command line options to existing Geeqie process.</entry>
+ </row>
+ <row>
+ <entry>-rh</entry>
+ <entry>--remote-help</entry>
+ <entry>List command line options available to --remote.</entry>
+ </row>
+ <row>
+ <entry>-h</entry>
+ <entry>--help</entry>
+ <entry>Display brief command line option list.</entry>
+ </row>
+ <row>
+ <entry>-v</entry>
+ <entry>--version</entry>
+ <entry>Display version of Geeqie.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--debug[=<level>]</entry>
+ <entry>Turn on debugging output (when compiled with Debug enabled). <level> is 0 to 4.</entry>
+ </row>
+ <row>
+ <entry>-g:<regexp></entry>
+ <entry>--grep:<regexp></entry>
+ <entry>Filter debug output with regular expression</entry>
+ </row>
+ <row>
+ <entry>+w</entry>
+ <entry>--show-log-window</entry>
+ <entry>Display log window</entry>
+ </row>
+ <row>
+ <entry>-o:<file></entry>
+ <entry>--log-file:<file></entry>
+ <entry>Save log data to file</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--alternate</entry>
+ <entry>Use alternate similarity algorithm - experimental - requires re-compile.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--disable-clutter</entry>
+ <entry>Disable use of Clutter library (i.e. GPU accel.). If the Clutter library is compiled into Geeqie but Clutter fails to initialize, it is necessary to start Geeqie with this option.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--cache-maintenance <path></entry>
+ <entry>
+ Run cache maintenance
+ <footnote id='cachemaintenance'>
+ <para><link linkend="CacheMaintenance">Cache Maintenance</link>.</para>
+ </footnote>
+ in non-GUI mode.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para />
+ <section id="Remotecommands">
+ <title>Remote commands</title>
+ <para>The --remote command line option will send all entered commands to an existing Geeqie process, a new process will be started if one does not exist. These are the additional commands that can be used with the remote command:</para>
+ <table frame="all">
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead rowsep="1" colsep="1">
+ <row>
+ <entry>Short Option</entry>
+ <entry>Long Option</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>-n</entry>
+ <entry>--next</entry>
+ <entry>Change main window to display next image.</entry>
+ </row>
+ <row>
+ <entry>-b</entry>
+ <entry>--back</entry>
+ <entry>Change main window to display previous image.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--first</entry>
+ <entry>Change main window to display first image.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--last</entry>
+ <entry>Change main window to display last image.</entry>
+ </row>
+ <row>
+ <entry>-f</entry>
+ <entry>--fullscreen</entry>
+ <entry>Toggle full screen mode of the main window.</entry>
+ </row>
+ <row>
+ <entry>-fs</entry>
+ <entry>--fullscreen-start</entry>
+ <entry>Start full screen mode for main window.</entry>
+ </row>
+ <row>
+ <entry>-fS</entry>
+ <entry>--fullscreen-stop</entry>
+ <entry>Stop full screen mode for main window.</entry>
+ </row>
+ <row>
+ <entry>-s</entry>
+ <entry>--slideshow</entry>
+ <entry>Toggle slide show for main window.</entry>
+ </row>
+ <row>
+ <entry>-ss</entry>
+ <entry>--slideshow-start</entry>
+ <entry>Start slide show for main window.</entry>
+ </row>
+ <row>
+ <entry>-sS</entry>
+ <entry>--slideshow-stop</entry>
+ <entry>Stop slide show for main window.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--slideshow-recurse:<folder></entry>
+ <entry>Start recursive slide show for <folder> in main window.</entry>
+ </row>
+ <row>
+ <entry>-d<[h:][m:][n][.m]></entry>
+ <entry>--delay=<[h:][m:][n][.m]></entry>
+ <entry>Set slide show delay to <[hrs:][mins:][n][.m]> seconds, range is 0.1 secs to 24 hours</entry>
+ </row>
+ <row>
+ <entry>+t</entry>
+ <entry>--tools-show</entry>
+ <entry>Show tools for main window.</entry>
+ </row>
+ <row>
+ <entry>-t</entry>
+ <entry>--tools-hide</entry>
+ <entry>Hide tools for main window.</entry>
+ </row>
+ <row>
+ <entry>-q</entry>
+ <entry>--quit</entry>
+ <entry>Quit Geeqie.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--config-load:<file>|layout ID</entry>
+ <entry>Load configuration from <file>. Use either a full path, or a saved window layout ID.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-sidecars:<file></entry>
+ <entry>Get list of sidecars of <file>.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-destination:<file></entry>
+ <entry>Get destination path of <file>. This is used by the symlink desktop file to implement the symbolic link operation. There is no useful function for the user.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>file:<file>|<URL></entry>
+ <entry>Open <file> or <URL> and bring Geeqie window to the top</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--file:<file>|<URL></entry>
+ <entry>Open <file> or <URL> and bring Geeqie window to the top</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>File:<file>|<URL></entry>
+ <entry>Open <file> or <URL> and do not bring Geeqie window to the top</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--File:<file>|<URL></entry>
+ <entry>Open <file> or <URL> and do not bring Geeqie window to the top</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--tell</entry>
+ <entry>Print filename [and Collection] of current image</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--pixel-info</entry>
+ <entry>Print X, Y and RGB of mouse pointer on current image</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-rectangle</entry>
+ <entry>Get rectangle coordinates</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-render-intent</entry>
+ <entry>Get render intent</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-filelist:[<FOLDER>]</entry>
+ <entry>Get list of files and class</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-filelist-recurse:[<FOLDER>]</entry>
+ <entry>Get list of files and class recursive</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-collection:<COLLECTION></entry>
+ <entry>Get collection content</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-collection-list</entry>
+ <entry>Get collection list</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--get-file-info</entry>
+ <entry>
+ Get file info
+ <footnote id='fileinfo'>
+ <para>File info consists of: class, no. of pages (if multi-page image), (and if exif exists) country name, country code, timezone, local time.</para>
+ </footnote>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>view:<file></entry>
+ <entry>Open new window containing <file></entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--view:<file></entry>
+ <entry>Open new window containing <file></entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--list-clear</entry>
+ <entry>Clear command line collection list</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--list-add:<file></entry>
+ <entry>Add <file> to command line collection list</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>raise</entry>
+ <entry>Bring the geeqie window to the top</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--raise</entry>
+ <entry>Bring the geeqie window to the top</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--id:<ID></entry>
+ <entry>
+ Window ID for following commands
+ <footnote id='ref3'>
+ <para>The ID is shown in the titlebar of the window. If multiple windows are open, it can be used to direct commands to a particular window e.g. --remote --id:main --tell</para>
+ </footnote>
+ </entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--new-window</entry>
+ <entry>Open new window</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--close-window</entry>
+ <entry>Close window</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--geometry=[<w>x<h>][+<x>+<y>]</entry>
+ <entry>Set the <width> <height> <xoffset> <yoffset> of the window. The parameters are in pixels.</entry>
+ </row>
+ <row>
+ <entry>-ct:clear|clean</entry>
+ <entry>--cache-thumbs:clear|clean</entry>
+ <entry>clear or clean thumbnail cache</entry>
+ </row>
+ <row>
+ <entry>-cs:clear|clean</entry>
+ <entry>--cache-shared:clear|clean</entry>
+ <entry>clear or clean shared thumbnail cache</entry>
+ </row>
+ <row>
+ <entry>-cm</entry>
+ <entry>--cache-metadata</entry>
+ <entry>clean the metadata cache</entry>
+ </row>
+ <row>
+ <entry>-cr:<folder></entry>
+ <entry>--cache-render:<folder></entry>
+ <entry>render thumbnails</entry>
+ </row>
+ <row>
+ <entry>-crr:<folder></entry>
+ <entry>--cache-render-recurse:<folder></entry>
+ <entry>render thumbnails recursively</entry>
+ </row>
+ <row>
+ <entry>-crs:<folder></entry>
+ <entry>--cache-render-shared:<folder></entry>
+ <entry>
+ render thumbnails
+ <footnote id='ref2'>
+ <para>If standard thumbnail cache is not enabled, this command will be ignored.</para>
+ </footnote>
+ </entry>
+ </row>
+ <row>
+ <entry>-crsr:<folder></entry>
+ <entry>--cache-render-shared-recurse:<folder></entry>
+ <entry>render thumbnails recursively</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--lua:<file>,<lua script></entry>
+ <entry>run lua script on file</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--PWD:<PWD></entry>
+ <entry>Use PWD as working directory for following commands</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>--print0</entry>
+ <entry>Terminate returned data with null character instead of newline</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceConfig">\r
- <title id="titleGuideReferenceConfig">Configuration Files and Locations</title>\r
- <para>The following data lists the locations Geeqie uses for various actions. The uppercase symbols are environment variables. If they are not set on your system the fallback locations are listed in parentheses.</para>\r
- <para>\r
- Geeqie will first attempt to load a configuration file from:\r
- <programlisting xml:space="preserve">/etc/geeqie/geeqierc.xml</programlisting>\r
- </para>\r
- <para>It will then continue with the following locations.</para>\r
- <para>\r
- Most of Geeqie's configuration files are contained in the folder, and sub-folders of:\r
- <programlisting xml:space="preserve">$XDG_CONFIG_HOME/geeqie/</programlisting>\r
- <programlisting xml:space="preserve">($HOME/.config/geeqie/)</programlisting>\r
- </para>\r
- <para>\r
- Geeqie's standard configuration file is:\r
- <programlisting xml:space="preserve">.../geeqierc.xml</programlisting>\r
- </para>\r
- <para>\r
- An alternative configuration file may be used by executing:\r
- <programlisting xml:space="preserve">geeqie -r --config-load:<filename></programlisting>\r
- </para>\r
- <para>\r
- Saved window layout files are in the folder:\r
- <programlisting xml:space="preserve">.../layouts</programlisting>\r
- </para>\r
- <para>\r
- Geeqie-created desktop files used by\r
- <link linkend="GuideImageManagementPlugins">Plugins</link>\r
- are in the folder:\r
- <programlisting xml:space="preserve">.../applications</programlisting>\r
- </para>\r
- <para>\r
- Lua script files for\r
- <link linkend="GuideReferenceLua">Lua Extensions</link>\r
- are in the folder:\r
- <programlisting xml:space="preserve">.../lua</programlisting>\r
- </para>\r
- <para>\r
- Historic data such as last several folders visited, bookmarks, and recently used collections, as well as default print settings are contained in this text file:\r
- <programlisting xml:space="preserve">.../history</programlisting>\r
- </para>\r
- <para>\r
- Keyboard shortcut maps are contained in this text file:\r
- <programlisting xml:space="preserve">.../accels</programlisting>\r
- </para>\r
- <para>\r
- The location for Collections is in the folder:\r
- <programlisting xml:space="preserve">$XDG_DATA_HOME/geeqie/collections</programlisting>\r
- <programlisting xml:space="preserve">($HOME/.local/share/geeqie/collections)</programlisting>\r
- </para>\r
- <para>\r
- The lirc\r
- <link linkend="GuideReferenceLIRC" endterm="titleGuideReferenceLIRC" />\r
- configuration file must be located at:\r
- <programlisting xml:space="preserve">$HOME/.lircrc</programlisting>\r
- </para>\r
- <para>\r
- Thumbnails are stored in a location specified in\r
- <link linkend="PreferencesThumbnails">Thumbnail Preferences</link>\r
- </para>\r
- <para>\r
- Metadata is stored either in the image file or in the location specified in\r
- <link linkend="MetadataWritingProcess">Metadata</link>\r
- </para>\r
- <para>\r
- Similarity files are stored in the folder:\r
- <programlisting xml:space="preserve">($HOME/.cache/geeqie/)</programlisting>\r
- </para>\r
- <para>\r
- The safe delete folder is specified in the\r
- <link linkend="Delete">Safe Delete</link>\r
- tab of main Preferences\r
- </para>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceConfig">
+ <title id="titleGuideReferenceConfig">Configuration Files and Locations</title>
+ <para>The following data lists the locations Geeqie uses for various actions. The uppercase symbols are environment variables. If they are not set on your system the fallback locations are listed in parentheses.</para>
+ <para>
+ Geeqie will first attempt to load a configuration file from:
+ <programlisting xml:space="preserve">/etc/geeqie/geeqierc.xml</programlisting>
+ </para>
+ <para>It will then continue with the following locations.</para>
+ <para>
+ Most of Geeqie's configuration files are contained in the folder, and sub-folders of:
+ <programlisting xml:space="preserve">$XDG_CONFIG_HOME/geeqie/</programlisting>
+ <programlisting xml:space="preserve">($HOME/.config/geeqie/)</programlisting>
+ </para>
+ <para>
+ Geeqie's standard configuration file is:
+ <programlisting xml:space="preserve">.../geeqierc.xml</programlisting>
+ </para>
+ <para>
+ An alternative configuration file may be used by executing:
+ <programlisting xml:space="preserve">geeqie -r --config-load:<filename></programlisting>
+ </para>
+ <para>
+ Saved window layout files are in the folder:
+ <programlisting xml:space="preserve">.../layouts</programlisting>
+ </para>
+ <para>
+ Geeqie-created desktop files used by
+ <link linkend="GuideImageManagementPlugins">Plugins</link>
+ are in the folder:
+ <programlisting xml:space="preserve">.../applications</programlisting>
+ </para>
+ <para>
+ Lua script files for
+ <link linkend="GuideReferenceLua">Lua Extensions</link>
+ are in the folder:
+ <programlisting xml:space="preserve">.../lua</programlisting>
+ </para>
+ <para>
+ Historic data such as last several folders visited, bookmarks, and recently used collections, as well as default print settings are contained in this text file:
+ <programlisting xml:space="preserve">.../history</programlisting>
+ </para>
+ <para>
+ Keyboard shortcut maps are contained in this text file:
+ <programlisting xml:space="preserve">.../accels</programlisting>
+ </para>
+ <para>
+ The location for Collections is in the folder:
+ <programlisting xml:space="preserve">$XDG_DATA_HOME/geeqie/collections</programlisting>
+ <programlisting xml:space="preserve">($HOME/.local/share/geeqie/collections)</programlisting>
+ </para>
+ <para>
+ The lirc
+ <link linkend="GuideReferenceLIRC" endterm="titleGuideReferenceLIRC" />
+ configuration file must be located at:
+ <programlisting xml:space="preserve">$HOME/.lircrc</programlisting>
+ </para>
+ <para>
+ Thumbnails are stored in a location specified in
+ <link linkend="PreferencesThumbnails">Thumbnail Preferences</link>
+ </para>
+ <para>
+ Metadata is stored either in the image file or in the location specified in
+ <link linkend="MetadataWritingProcess">Metadata</link>
+ </para>
+ <para>
+ Similarity files are stored in the folder:
+ <programlisting xml:space="preserve">($HOME/.cache/geeqie/)</programlisting>
+ </para>
+ <para>
+ The safe delete folder is specified in the
+ <link linkend="Delete">Safe Delete</link>
+ tab of main Preferences
+ </para>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceDecodeLatLong">\r
- <title id="titleGuideReferenceDecodeLatLong">Decoding Latitude and Longitude</title>\r
- <para>This section is relevant to geocode searches and the map display of Geeqie.</para>\r
- <para>\r
- The result of some internet or other searches for placenames can contain a latitude and longitude embedded in a text string. For example an openstreetmap.org search can give a URL such as:\r
- <para />\r
- <code>https://www.openstreetmap.org/search?query=51.5542%2C-0.1816#map=12/51.5542/-0.1818</code>\r
- </para>\r
- <para>\r
- If you paste such a string into the search box, the latitude/longitude can be automatically extracted and used as the origin of the search.\r
- <para />\r
- You may also drag-and-drop a URL of this type onto the map to cause the map to be re-centered.\r
- <para />\r
- This feature uses the file:\r
- <para />\r
- <code>/usr/local/lib/geeqie/geocode-parameters.awk</code>\r
- <para />\r
- You may create your own decodes by using the above file as an example, and storing the file in:\r
- <para />\r
- <code>~/.config/geeqie/applications/geocode-parameters.awk</code>\r
- <para />\r
- If a successful decode was not made from the first file, your local version will then be used.\r
- </para>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceDecodeLatLong">
+ <title id="titleGuideReferenceDecodeLatLong">Decoding Latitude and Longitude</title>
+ <para>This section is relevant to geocode searches and the map display of Geeqie.</para>
+ <para>
+ The result of some internet or other searches for placenames can contain a latitude and longitude embedded in a text string. For example an openstreetmap.org search can give a URL such as:
+ <para />
+ <code>https://www.openstreetmap.org/search?query=51.5542%2C-0.1816#map=12/51.5542/-0.1818</code>
+ </para>
+ <para>
+ If you paste such a string into the search box, the latitude/longitude can be automatically extracted and used as the origin of the search.
+ <para />
+ You may also drag-and-drop a URL of this type onto the map to cause the map to be re-centered.
+ <para />
+ This feature uses the file:
+ <para />
+ <code>/usr/local/lib/geeqie/geocode-parameters.awk</code>
+ <para />
+ You may create your own decodes by using the above file as an example, and storing the file in:
+ <para />
+ <code>~/.config/geeqie/applications/geocode-parameters.awk</code>
+ <para />
+ If a successful decode was not made from the first file, your local version will then be used.
+ </para>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceFileDates">\r
- <title>File date types</title>\r
- <para>Geeqie understands 4 types of file dates:</para>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>Standard date (mtime) - The date the file contents were last modified, or when the file was created if since unchanged.</para>\r
- </listitem>\r
- <listitem>\r
- <para>Status changed (ctime) - The date the file status was last changed. This includes change of owner, change of read/write permission and change of contents.</para>\r
- </listitem>\r
- <listitem>\r
- <para>Exif date original (Exif.Photo.DateTimeOriginal) - For images from a digital camera, this is the time the photo was taken.</para>\r
- </listitem>\r
- <listitem>\r
- <para>Exif date digitized (Exif.Photo.DateTimeDigitized) - For scanned images, this the time the scan was made. For images from a digital camera, it may be identical to the above date.</para>\r
- </listitem>\r
- </itemizedlist>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceFileDates">
+ <title>File date types</title>
+ <para>Geeqie understands 4 types of file dates:</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Standard date (mtime) - The date the file contents were last modified, or when the file was created if since unchanged.</para>
+ </listitem>
+ <listitem>
+ <para>Status changed (ctime) - The date the file status was last changed. This includes change of owner, change of read/write permission and change of contents.</para>
+ </listitem>
+ <listitem>
+ <para>Exif date original (Exif.Photo.DateTimeOriginal) - For images from a digital camera, this is the time the photo was taken.</para>
+ </listitem>
+ <listitem>
+ <para>Exif date digitized (Exif.Photo.DateTimeDigitized) - For scanned images, this the time the scan was made. For images from a digital camera, it may be identical to the above date.</para>
+ </listitem>
+ </itemizedlist>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceKeyboardShortcuts">\r
- <title id="titleGuideReferenceKeyboardShortcuts">Keyboard and Mouse Shortcuts</title>\r
- <para>\r
- The tables below shows the defaults for keyboard shortcuts. The current settings for all shortcuts may be found in the\r
- <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />\r
- dialogue.\r
- </para>\r
- <section id="AllWindows">\r
- <title>Keyboard shortcuts in all windows</title>\r
- <table frame="all">\r
- <title>Standard keyboard shortcuts</title>\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>Shortcut</entry>\r
- <entry>Mouse</entry>\r
- <entry>Action</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <keycap>F1</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Help.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Menu</keycap>\r
- </entry>\r
- <entry>Right-click</entry>\r
- <entry>Context menu.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>F10</keycap>\r
- </entry>\r
- <entry>Right-click</entry>\r
- <entry>Context menu.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>/</keycap>\r
- </entry>\r
- <entry/>\r
- <entry>Search and Run Commands.</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
- <section id="mainKeyboard">\r
- <title>Main window keyboard shortcuts</title>\r
- <table frame="all">\r
- <title>\r
- <link linkend="GuideMainWindow">Main window</link>\r
- keyboard shortcuts\r
- </title>\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>Shortcut</entry>\r
- <entry>Mouse</entry>\r
- <entry>Action</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row colsep="0">\r
- <entry colsep="0">\r
- <emphasis role="strong">Image Navigation</emphasis>\r
- </entry>\r
- <entry colsep="0" />\r
- <entry />\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>PageDown</keycap>\r
- </entry>\r
- <entry>\r
- <code>Left Click</code>\r
- ,\r
- <para />\r
- <code>Mouse Wheel down</code>\r
- <footnote id='ref1'>\r
- <para>\r
- Default Mouse wheel functions can be altered by changing the\r
- <link linkend="GuideOptionsBehavior">Mouse wheel scrolls image</link>\r
- option.\r
- </para>\r
- </footnote>\r
- </entry>\r
- <entry>Change to next image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>PageUp</keycap>\r
- </entry>\r
- <entry>\r
- <code>Middle Click</code>\r
- ,\r
- <para />\r
- <code>Mouse Wheel up</code>\r
- <footnoteref linkend='ref1' />\r
- </entry>\r
- <entry>Change to previous image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Home</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Change to first image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>End</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Change to last image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Space</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Change to next image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Backspace</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Change to previous image.</entry>\r
- </row>\r
- <row rowsep="0">\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry colsep="0">\r
- <emphasis role="strong">Image viewing</emphasis>\r
- (image has keyboard focus. Refer also to\r
- <link linkend="MouseWheelMode">Mouse Wheel Mode</link>\r
- )\r
- </entry>\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Arrow key</keycap>\r
- </entry>\r
- <entry>\r
- <code>Left click and Drag</code>\r
- <footnoteref linkend='ref1' />\r
- </entry>\r
- <entry>Pan image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Shift + Arrows</code>\r
- </entry>\r
- <entry />\r
- <entry>Pan Image faster.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Ctrl + Arrow key</code>\r
- </entry>\r
- <entry />\r
- <entry>Pan to respective edge of image.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>\r
- <code>Mouse button 8</code>\r
- <footnote id='ref2'>\r
- <para>Requires a multi-button mouse.</para>\r
- </footnote>\r
- </entry>\r
- <entry>Forward</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>\r
- <code>Mouse button 9</code>\r
- <footnoteref linkend='ref2' />\r
- </entry>\r
- <entry>Back</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>\r
- <code>Shift + right-click</code>\r
- </entry>\r
- <entry>Smooth scroll</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>]</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Rotate image clockwise 90 degrees.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>[</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Rotate image counterclockwise 90 degree.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Shift + R</code>\r
- </entry>\r
- <entry />\r
- <entry>Rotate image 180 degrees.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Shift + M</code>\r
- </entry>\r
- <entry />\r
- <entry>Flip image horizontally (mirror).</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Shift + F</code>\r
- </entry>\r
- <entry />\r
- <entry>Flip image vertically.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>+</keycap>\r
- ,\r
- <keycap>=</keycap>\r
- </entry>\r
- <entry>\r
- <code>Ctrl + Mouse Wheel up</code>\r
- </entry>\r
- <entry>Zoom image in.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>-</keycap>\r
- </entry>\r
- <entry>\r
- <code>Ctrl + Mouse Wheel down</code>\r
- </entry>\r
- <entry>Zoom image out.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Z</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Reset zoom to original size (1:1).</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>X</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Fit image to window size.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>W</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Zoom image to fit window width.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>H</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Zoom image to fit window height.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>1</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 1:1</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>2</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 2:1</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>3</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 3:1</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>4</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 4:1</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>7</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 1:4</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>8</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 1:3</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>9</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 1:2</entry>\r
- </row>\r
- <row rowsep="0">\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry colsep="0">\r
- <emphasis role="strong">For files with multiple pages e.g. tiff files</emphasis>\r
- </entry>\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>Home</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Go to first page</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>End</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Go to last page</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>PageUp</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Go to previous page</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>PageDown</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Go to next page</entry>\r
- </row>\r
- <row>\r
- <entry colsep="0">\r
- <emphasis role="strong">File Menu</emphasis>\r
- </entry>\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>N</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>New Window</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>C</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Open a new empty collection window.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>O</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Display open collection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>F3</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Open new search window.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Shift +\r
- <keycap>P</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Open print dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>F</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Create new folder in current path.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>C</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Copy selected images, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>M</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Move selected images, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>R</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Rename selected images, opens rename dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>D</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Move selected images to trash bin.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Shift + Delete</code>\r
- </entry>\r
- <entry />\r
- <entry>Permanently delete selected images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>W</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Close window, Geeqie exits when last window is closed.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>Q</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Quit Geeqie.</entry>\r
- </row>\r
- <row rowsep="0">\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry colsep="0">\r
- <emphasis role="strong">Edit Menu</emphasis>\r
- </entry>\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>O</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Open Geeqie preferences window.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>S</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Save metadata</entry>\r
- </row>\r
- <row rowsep="0">\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry colsep="0">\r
- <emphasis role="strong">Select Menu</emphasis>\r
- </entry>\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>1</keycap>\r
- ...\r
- <keycap>6</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Toggle mark 1 ... 6</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>1</keycap>\r
- </code>\r
- ...\r
- <code>\r
- Ctrl +\r
- <keycap>6</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Select mark 1 ... 6</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>A</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Select all images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl + SHIFT +\r
- <keycap>A</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Unselect all images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl + SHIFT +\r
- <keycap>I</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Invert selection.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Alt +\r
- <keycap>R</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle rectangular selection mode in icon view.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>M</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Show marks.</entry>\r
- </row>\r
- <row rowsep="0">\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry colsep="0">\r
- <emphasis role="strong">View Menu</emphasis>\r
- </entry>\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>T</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Toggle display of thumbnails when in list view.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>L</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Display file list as detailed list view.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>I</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Display file list as icon view.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>T</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle folder display between list and tree views.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>R</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Refresh file list.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>L</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Toggle floating of file display.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>H</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle hiding of file display.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>E</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle EXIF sidebar.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Shift +\r
- <keycap>S</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle Sort Manager sidebar.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>K</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle Keywords sidebar.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Shift +\r
- <keycap>E</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle highlighting of pixels that are over or under exposed.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>V</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Toggle full screen.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>I</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Toggle information overlay.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>S</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Toggle slideshow.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>P</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Pause slideshow.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>=</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Slideshow faster.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>-</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Slideshow slower.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>E</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Split panes horizontal.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>U</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Split panes vertical.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Y</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Single pane.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Alt + Right Arrow</code>\r
- </entry>\r
- <entry />\r
- <entry>Next split pane.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Alt + Left Arrow</code>\r
- </entry>\r
- <entry />\r
- <entry>Previous split pane.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Alt + Up Arrow</code>\r
- </entry>\r
- <entry />\r
- <entry>Up or previous split pane.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Alt + Down Arrow</code>\r
- </entry>\r
- <entry />\r
- <entry>Down or next split pane.</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
- <section id="CollectionsKeyboardShortcuts">\r
- <title>Collections keyboard shortcuts</title>\r
- <table frame="all">\r
- <title>\r
- <link linkend="GuideCollections">Collections window</link>\r
- keyboard shortcuts\r
- </title>\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>Shortcut</entry>\r
- <entry>Mouse</entry>\r
- <entry>Action</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <entry colsep="0">\r
- <emphasis role="strong">Collection Window</emphasis>\r
- </entry>\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- <row>\r
- <entry>\r
- <keycap>Arrows</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Move selection.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Shift + Arrow key</code>\r
- </entry>\r
- <entry />\r
- <entry>Select multiple images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Alt +\r
- <keycap>R</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle rectangular selection mode.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Space</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Select only image with focus.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Ctrl + Space</code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle selection of image with focus.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Home</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Move focus to first image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>End</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Move focus to last image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>A</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Select all images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl + Shift +\r
- <keycap>A</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Unselect all images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Delete</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Remove selected image from collection, does not delete image from disk.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>L</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Add images from main window's file list.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>T</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle display of icon filenames.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>N</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Sort collection by name.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>D</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Sort collection by file date.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>B</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Sort collection by file size.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>P</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Sort collection by file path.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>I</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Sort collection by natural numerical order.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Enter</keycap>\r
- </entry>\r
- <entry />\r
- <entry>View image with focus in main window.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>V</keycap>\r
- </entry>\r
- <entry />\r
- <entry>View image with focus in new window.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Shift +\r
- <keycap>P</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Open print dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>S</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Save collection.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>S</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Save collection as, opens destination dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>A</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Append to collection, opens append dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>C</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Copy selected images, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>M</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Move selected images, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>R</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Rename selected images, opens rename dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>D</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Delete selected images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>W</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Close collection window.</entry>\r
- </row>\r
- <row rowsep="0">\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- <entry colsep="0" />\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
- <section id="DuplicatesKeyboardShortcuts">\r
- <title>Duplicates keyboard shortcuts</title>\r
- <table frame="all">\r
- <title>\r
- <link linkend="GuideImageSearchFindingDuplicates">Duplicates window</link>\r
- keyboard shortcuts\r
- </title>\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>Shortcut</entry>\r
- <entry>Mouse</entry>\r
- <entry>Action</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <keycap>0</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Select none.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>1</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Select group 1 duplicates.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>2</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Select group 2 duplicates.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>C</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Open new collection window and add selected images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>L</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Add images from main window's list.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>V</keycap>\r
- </entry>\r
- <entry />\r
- <entry>View selected item in new window.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>T</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle thumbnails.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>A</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Select all.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl + shift +\r
- <keycap>A</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Deselect all.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>C</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Copy selected images, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>M</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Move selected images, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>R</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Rename selected images, opens rename dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>D</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Delete selected images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Ctrl + Delete</code>\r
- </entry>\r
- <entry />\r
- <entry>Remove all items from list.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>W</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Close window.</entry>\r
- </row>\r
- <row>\r
- <entry />\r
- <entry>\r
- <code>Ctrl + shift + right-click</code>\r
- </entry>\r
- <entry>Show debug info.</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
- <section id="SearchKeyboardShortcuts">\r
- <title>Search keyboard shortcuts</title>\r
- <table frame="all">\r
- <title>\r
- <link linkend="GuideImageSearchSearch">Search window</link>\r
- keyboard shortcuts\r
- </title>\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>Shortcut</entry>\r
- <entry>Mouse</entry>\r
- <entry>Action</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>C</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Copy selected images, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>M</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Move selected images, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>R</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Rename selected images, opens rename dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>D</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Delete selected images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>A</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Select all.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl + shift +\r
- <keycap>A</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Deselect all.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Delete</code>\r
- </entry>\r
- <entry />\r
- <entry>Remove selected items from list.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>Ctrl + Delete</code>\r
- </entry>\r
- <entry />\r
- <entry>Remove all items from list.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>V</keycap>\r
- </entry>\r
- <entry />\r
- <entry>View selected item in new window.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>C</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Open new collection window and add selected images.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>T</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Toggle thumbnails.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>W</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Close window.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>Enter</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Start/Stop search.</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
- <section id="PanViewKeyboardShortcuts">\r
- <title>Pan view keyboard shortcuts</title>\r
- <table frame="all">\r
- <title>\r
- <link linkend="GuideOtherWindowsPanView">Pan View window</link>\r
- keyboard shortcuts\r
- </title>\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>Shortcut</entry>\r
- <entry>Mouse</entry>\r
- <entry>Action</entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <keycap>Arrow key</keycap>\r
- </entry>\r
- <entry>\r
- <code>Left click and Drag</code>\r
- <footnoteref linkend='ref1' />\r
- </entry>\r
- <entry>Scroll display.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Page Up</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Scroll display half screen up.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Page Down</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Scroll display half screen down.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Home</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Scroll display half screen left.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>End</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Scroll display half screen right.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>F</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Display Find search bar.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>/</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Display Find search bar.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>G</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Start search.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>F11, F, V</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Toggle Fullscreen.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Esc</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Exit fullscreen or clear search bar.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>+</keycap>\r
- ,\r
- <keycap>=</keycap>\r
- </entry>\r
- <entry>\r
- <code>Ctrl + Mouse Wheel up</code>\r
- </entry>\r
- <entry>Zoom image in.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>-</keycap>\r
- </entry>\r
- <entry>\r
- <code>Ctrl + Mouse Wheel down</code>\r
- </entry>\r
- <entry>Zoom image out.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>Z</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Reset zoom to original size (1:1).</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>1</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 1:1</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>2</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 2:1</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>3</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 3:1</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>4</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 4:1</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>7</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 1:4</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>8</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 1:3</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <keycap>9</keycap>\r
- </entry>\r
- <entry />\r
- <entry>Set zoom to 1:2</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>C</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Copy selected image, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>M</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Move selected image, opens destination selection dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>R</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Rename selected image, opens rename dialog.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>D</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Delete selected image.</entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <code>\r
- Ctrl +\r
- <keycap>W</keycap>\r
- </code>\r
- </entry>\r
- <entry />\r
- <entry>Close window.</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceKeyboardShortcuts">
+ <title id="titleGuideReferenceKeyboardShortcuts">Keyboard and Mouse Shortcuts</title>
+ <para>
+ The tables below shows the defaults for keyboard shortcuts. The current settings for all shortcuts may be found in the
+ <link linkend="GuideOptionsKeyboard" endterm="titleGuideOptionsKeyboard" />
+ dialogue.
+ </para>
+ <section id="AllWindows">
+ <title>Keyboard shortcuts in all windows</title>
+ <table frame="all">
+ <title>Standard keyboard shortcuts</title>
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>Shortcut</entry>
+ <entry>Mouse</entry>
+ <entry>Action</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <keycap>F1</keycap>
+ </entry>
+ <entry />
+ <entry>Help.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Menu</keycap>
+ </entry>
+ <entry>Right-click</entry>
+ <entry>Context menu.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>F10</keycap>
+ </entry>
+ <entry>Right-click</entry>
+ <entry>Context menu.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>/</keycap>
+ </entry>
+ <entry/>
+ <entry>Search and Run Commands.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ <section id="mainKeyboard">
+ <title>Main window keyboard shortcuts</title>
+ <table frame="all">
+ <title>
+ <link linkend="GuideMainWindow">Main window</link>
+ keyboard shortcuts
+ </title>
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>Shortcut</entry>
+ <entry>Mouse</entry>
+ <entry>Action</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row colsep="0">
+ <entry colsep="0">
+ <emphasis role="strong">Image Navigation</emphasis>
+ </entry>
+ <entry colsep="0" />
+ <entry />
+ </row>
+ <row>
+ <entry>
+ <keycap>PageDown</keycap>
+ </entry>
+ <entry>
+ <code>Left Click</code>
+ ,
+ <para />
+ <code>Mouse Wheel down</code>
+ <footnote id='ref1'>
+ <para>
+ Default Mouse wheel functions can be altered by changing the
+ <link linkend="GuideOptionsBehavior">Mouse wheel scrolls image</link>
+ option.
+ </para>
+ </footnote>
+ </entry>
+ <entry>Change to next image.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>PageUp</keycap>
+ </entry>
+ <entry>
+ <code>Middle Click</code>
+ ,
+ <para />
+ <code>Mouse Wheel up</code>
+ <footnoteref linkend='ref1' />
+ </entry>
+ <entry>Change to previous image.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Home</keycap>
+ </entry>
+ <entry />
+ <entry>Change to first image.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>End</keycap>
+ </entry>
+ <entry />
+ <entry>Change to last image.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Space</keycap>
+ </entry>
+ <entry />
+ <entry>Change to next image.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Backspace</keycap>
+ </entry>
+ <entry />
+ <entry>Change to previous image.</entry>
+ </row>
+ <row rowsep="0">
+ <entry colsep="0" />
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry colsep="0">
+ <emphasis role="strong">Image viewing</emphasis>
+ (image has keyboard focus. Refer also to
+ <link linkend="MouseWheelMode">Mouse Wheel Mode</link>
+ )
+ </entry>
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry>
+ <keycap>Arrow key</keycap>
+ </entry>
+ <entry>
+ <code>Left click and Drag</code>
+ <footnoteref linkend='ref1' />
+ </entry>
+ <entry>Pan image.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Shift + Arrows</code>
+ </entry>
+ <entry />
+ <entry>Pan Image faster.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Ctrl + Arrow key</code>
+ </entry>
+ <entry />
+ <entry>Pan to respective edge of image.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>
+ <code>Mouse button 8</code>
+ <footnote id='ref2'>
+ <para>Requires a multi-button mouse.</para>
+ </footnote>
+ </entry>
+ <entry>Forward</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>
+ <code>Mouse button 9</code>
+ <footnoteref linkend='ref2' />
+ </entry>
+ <entry>Back</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>
+ <code>Shift + right-click</code>
+ </entry>
+ <entry>Smooth scroll</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>]</keycap>
+ </entry>
+ <entry />
+ <entry>Rotate image clockwise 90 degrees.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>[</keycap>
+ </entry>
+ <entry />
+ <entry>Rotate image counterclockwise 90 degree.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Shift + R</code>
+ </entry>
+ <entry />
+ <entry>Rotate image 180 degrees.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Shift + M</code>
+ </entry>
+ <entry />
+ <entry>Flip image horizontally (mirror).</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Shift + F</code>
+ </entry>
+ <entry />
+ <entry>Flip image vertically.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>+</keycap>
+ ,
+ <keycap>=</keycap>
+ </entry>
+ <entry>
+ <code>Ctrl + Mouse Wheel up</code>
+ </entry>
+ <entry>Zoom image in.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>-</keycap>
+ </entry>
+ <entry>
+ <code>Ctrl + Mouse Wheel down</code>
+ </entry>
+ <entry>Zoom image out.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Z</keycap>
+ </entry>
+ <entry />
+ <entry>Reset zoom to original size (1:1).</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>X</keycap>
+ </entry>
+ <entry />
+ <entry>Fit image to window size.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>W</keycap>
+ </entry>
+ <entry />
+ <entry>Zoom image to fit window width.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>H</keycap>
+ </entry>
+ <entry />
+ <entry>Zoom image to fit window height.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>1</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 1:1</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>2</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 2:1</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>3</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 3:1</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>4</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 4:1</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>7</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 1:4</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>8</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 1:3</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>9</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 1:2</entry>
+ </row>
+ <row rowsep="0">
+ <entry colsep="0" />
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry colsep="0">
+ <emphasis role="strong">For files with multiple pages e.g. tiff files</emphasis>
+ </entry>
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>Home</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Go to first page</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>End</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Go to last page</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>PageUp</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Go to previous page</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>PageDown</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Go to next page</entry>
+ </row>
+ <row>
+ <entry colsep="0">
+ <emphasis role="strong">File Menu</emphasis>
+ </entry>
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>N</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>New Window</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>C</keycap>
+ </entry>
+ <entry />
+ <entry>Open a new empty collection window.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>O</keycap>
+ </entry>
+ <entry />
+ <entry>Display open collection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>F3</keycap>
+ </entry>
+ <entry />
+ <entry>Open new search window.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Shift +
+ <keycap>P</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Open print dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>F</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Create new folder in current path.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>C</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Copy selected images, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>M</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Move selected images, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>R</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Rename selected images, opens rename dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>D</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Move selected images to trash bin.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Shift + Delete</code>
+ </entry>
+ <entry />
+ <entry>Permanently delete selected images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>W</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Close window, Geeqie exits when last window is closed.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>Q</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Quit Geeqie.</entry>
+ </row>
+ <row rowsep="0">
+ <entry colsep="0" />
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry colsep="0">
+ <emphasis role="strong">Edit Menu</emphasis>
+ </entry>
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>O</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Open Geeqie preferences window.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>S</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Save metadata</entry>
+ </row>
+ <row rowsep="0">
+ <entry colsep="0" />
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry colsep="0">
+ <emphasis role="strong">Select Menu</emphasis>
+ </entry>
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry>
+ <keycap>1</keycap>
+ ...
+ <keycap>6</keycap>
+ </entry>
+ <entry />
+ <entry>Toggle mark 1 ... 6</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>1</keycap>
+ </code>
+ ...
+ <code>
+ Ctrl +
+ <keycap>6</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Select mark 1 ... 6</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>A</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Select all images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl + SHIFT +
+ <keycap>A</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Unselect all images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl + SHIFT +
+ <keycap>I</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Invert selection.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Alt +
+ <keycap>R</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle rectangular selection mode in icon view.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>M</keycap>
+ </entry>
+ <entry />
+ <entry>Show marks.</entry>
+ </row>
+ <row rowsep="0">
+ <entry colsep="0" />
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry colsep="0">
+ <emphasis role="strong">View Menu</emphasis>
+ </entry>
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ <row>
+ <entry>
+ <keycap>T</keycap>
+ </entry>
+ <entry />
+ <entry>Toggle display of thumbnails when in list view.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>L</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Display file list as detailed list view.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>I</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Display file list as icon view.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>T</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle folder display between list and tree views.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>R</keycap>
+ </entry>
+ <entry />
+ <entry>Refresh file list.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>L</keycap>
+ </entry>
+ <entry />
+ <entry>Toggle floating of file display.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>H</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle hiding of file display.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>E</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle EXIF sidebar.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Shift +
+ <keycap>S</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle Sort Manager sidebar.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>K</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle Keywords sidebar.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Shift +
+ <keycap>E</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle highlighting of pixels that are over or under exposed.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>V</keycap>
+ </entry>
+ <entry />
+ <entry>Toggle full screen.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>I</keycap>
+ </entry>
+ <entry />
+ <entry>Toggle information overlay.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>S</keycap>
+ </entry>
+ <entry />
+ <entry>Toggle slideshow.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>P</keycap>
+ </entry>
+ <entry />
+ <entry>Pause slideshow.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>=</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Slideshow faster.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>-</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Slideshow slower.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>E</keycap>
+ </entry>
+ <entry />
+ <entry>Split panes horizontal.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>U</keycap>
+ </entry>
+ <entry />
+ <entry>Split panes vertical.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Y</keycap>
+ </entry>
+ <entry />
+ <entry>Single pane.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Alt + Right Arrow</code>
+ </entry>
+ <entry />
+ <entry>Next split pane.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Alt + Left Arrow</code>
+ </entry>
+ <entry />
+ <entry>Previous split pane.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Alt + Up Arrow</code>
+ </entry>
+ <entry />
+ <entry>Up or previous split pane.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Alt + Down Arrow</code>
+ </entry>
+ <entry />
+ <entry>Down or next split pane.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ <section id="CollectionsKeyboardShortcuts">
+ <title>Collections keyboard shortcuts</title>
+ <table frame="all">
+ <title>
+ <link linkend="GuideCollections">Collections window</link>
+ keyboard shortcuts
+ </title>
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>Shortcut</entry>
+ <entry>Mouse</entry>
+ <entry>Action</entry>
+ </row>
+ </thead>
+ <tbody>
+ <entry colsep="0">
+ <emphasis role="strong">Collection Window</emphasis>
+ </entry>
+ <entry colsep="0" />
+ <entry colsep="0" />
+ <row>
+ <entry>
+ <keycap>Arrows</keycap>
+ </entry>
+ <entry />
+ <entry>Move selection.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Shift + Arrow key</code>
+ </entry>
+ <entry />
+ <entry>Select multiple images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Alt +
+ <keycap>R</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle rectangular selection mode.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Space</keycap>
+ </entry>
+ <entry />
+ <entry>Select only image with focus.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Ctrl + Space</code>
+ </entry>
+ <entry />
+ <entry>Toggle selection of image with focus.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Home</keycap>
+ </entry>
+ <entry />
+ <entry>Move focus to first image.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>End</keycap>
+ </entry>
+ <entry />
+ <entry>Move focus to last image.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>A</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Select all images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl + Shift +
+ <keycap>A</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Unselect all images.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Delete</keycap>
+ </entry>
+ <entry />
+ <entry>Remove selected image from collection, does not delete image from disk.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>L</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Add images from main window's file list.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>T</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle display of icon filenames.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>N</keycap>
+ </entry>
+ <entry />
+ <entry>Sort collection by name.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>D</keycap>
+ </entry>
+ <entry />
+ <entry>Sort collection by file date.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>B</keycap>
+ </entry>
+ <entry />
+ <entry>Sort collection by file size.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>P</keycap>
+ </entry>
+ <entry />
+ <entry>Sort collection by file path.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>I</keycap>
+ </entry>
+ <entry />
+ <entry>Sort collection by natural numerical order.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Enter</keycap>
+ </entry>
+ <entry />
+ <entry>View image with focus in main window.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>V</keycap>
+ </entry>
+ <entry />
+ <entry>View image with focus in new window.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Shift +
+ <keycap>P</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Open print dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>S</keycap>
+ </entry>
+ <entry />
+ <entry>Save collection.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>S</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Save collection as, opens destination dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>A</keycap>
+ </entry>
+ <entry />
+ <entry>Append to collection, opens append dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>C</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Copy selected images, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>M</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Move selected images, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>R</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Rename selected images, opens rename dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>D</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Delete selected images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>W</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Close collection window.</entry>
+ </row>
+ <row rowsep="0">
+ <entry colsep="0" />
+ <entry colsep="0" />
+ <entry colsep="0" />
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ <section id="DuplicatesKeyboardShortcuts">
+ <title>Duplicates keyboard shortcuts</title>
+ <table frame="all">
+ <title>
+ <link linkend="GuideImageSearchFindingDuplicates">Duplicates window</link>
+ keyboard shortcuts
+ </title>
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>Shortcut</entry>
+ <entry>Mouse</entry>
+ <entry>Action</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <keycap>0</keycap>
+ </entry>
+ <entry />
+ <entry>Select none.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>1</keycap>
+ </entry>
+ <entry />
+ <entry>Select group 1 duplicates.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>2</keycap>
+ </entry>
+ <entry />
+ <entry>Select group 2 duplicates.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>C</keycap>
+ </entry>
+ <entry />
+ <entry>Open new collection window and add selected images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>L</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Add images from main window's list.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>V</keycap>
+ </entry>
+ <entry />
+ <entry>View selected item in new window.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>T</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle thumbnails.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>A</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Select all.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl + shift +
+ <keycap>A</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Deselect all.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>C</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Copy selected images, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>M</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Move selected images, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>R</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Rename selected images, opens rename dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>D</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Delete selected images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Ctrl + Delete</code>
+ </entry>
+ <entry />
+ <entry>Remove all items from list.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>W</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Close window.</entry>
+ </row>
+ <row>
+ <entry />
+ <entry>
+ <code>Ctrl + shift + right-click</code>
+ </entry>
+ <entry>Show debug info.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ <section id="SearchKeyboardShortcuts">
+ <title>Search keyboard shortcuts</title>
+ <table frame="all">
+ <title>
+ <link linkend="GuideImageSearchSearch">Search window</link>
+ keyboard shortcuts
+ </title>
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>Shortcut</entry>
+ <entry>Mouse</entry>
+ <entry>Action</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>C</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Copy selected images, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>M</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Move selected images, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>R</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Rename selected images, opens rename dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>D</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Delete selected images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>A</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Select all.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl + shift +
+ <keycap>A</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Deselect all.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Delete</code>
+ </entry>
+ <entry />
+ <entry>Remove selected items from list.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>Ctrl + Delete</code>
+ </entry>
+ <entry />
+ <entry>Remove all items from list.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>V</keycap>
+ </entry>
+ <entry />
+ <entry>View selected item in new window.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>C</keycap>
+ </entry>
+ <entry />
+ <entry>Open new collection window and add selected images.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>T</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Toggle thumbnails.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>W</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Close window.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>Enter</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Start/Stop search.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ <section id="PanViewKeyboardShortcuts">
+ <title>Pan view keyboard shortcuts</title>
+ <table frame="all">
+ <title>
+ <link linkend="GuideOtherWindowsPanView">Pan View window</link>
+ keyboard shortcuts
+ </title>
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>Shortcut</entry>
+ <entry>Mouse</entry>
+ <entry>Action</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <keycap>Arrow key</keycap>
+ </entry>
+ <entry>
+ <code>Left click and Drag</code>
+ <footnoteref linkend='ref1' />
+ </entry>
+ <entry>Scroll display.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Page Up</keycap>
+ </entry>
+ <entry />
+ <entry>Scroll display half screen up.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Page Down</keycap>
+ </entry>
+ <entry />
+ <entry>Scroll display half screen down.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Home</keycap>
+ </entry>
+ <entry />
+ <entry>Scroll display half screen left.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>End</keycap>
+ </entry>
+ <entry />
+ <entry>Scroll display half screen right.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>F</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Display Find search bar.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>/</keycap>
+ </entry>
+ <entry />
+ <entry>Display Find search bar.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>G</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Start search.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>F11, F, V</keycap>
+ </entry>
+ <entry />
+ <entry>Toggle Fullscreen.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Esc</keycap>
+ </entry>
+ <entry />
+ <entry>Exit fullscreen or clear search bar.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>+</keycap>
+ ,
+ <keycap>=</keycap>
+ </entry>
+ <entry>
+ <code>Ctrl + Mouse Wheel up</code>
+ </entry>
+ <entry>Zoom image in.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>-</keycap>
+ </entry>
+ <entry>
+ <code>Ctrl + Mouse Wheel down</code>
+ </entry>
+ <entry>Zoom image out.</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>Z</keycap>
+ </entry>
+ <entry />
+ <entry>Reset zoom to original size (1:1).</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>1</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 1:1</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>2</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 2:1</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>3</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 3:1</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>4</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 4:1</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>7</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 1:4</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>8</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 1:3</entry>
+ </row>
+ <row>
+ <entry>
+ <keycap>9</keycap>
+ </entry>
+ <entry />
+ <entry>Set zoom to 1:2</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>C</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Copy selected image, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>M</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Move selected image, opens destination selection dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>R</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Rename selected image, opens rename dialog.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>D</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Delete selected image.</entry>
+ </row>
+ <row>
+ <entry>
+ <code>
+ Ctrl +
+ <keycap>W</keycap>
+ </code>
+ </entry>
+ <entry />
+ <entry>Close window.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceLIRC">\r
- <title id="titleGuideReferenceLIRC">Infra-red controller</title>\r
- <para>Recent Linux kernels have in-built support for ir devices, making lirc support redundant.</para>\r
- <para>If you wish to use lirc with Geeqie, the lirc libraries must be installed. If you are compiling from sources, lirc functionality will be available if the library dependencies are met.</para>\r
- <para>If you are using a pre-compiled distribution, availability depends on the package maintainer.</para>\r
- <para>\r
- The website\r
- <ulink url="http://www.lirc.org">Linux Infrared Remote Control</ulink>\r
- has detailed information on this subject.\r
- </para>\r
- <para>\r
- You will need to create a configuration file for the controller you will use. This file must be installed at the location specified in\r
- <link linkend="GuideReferenceConfig" endterm="titleGuideReferenceConfig" />\r
- .\r
- </para>\r
- <para>\r
- Here is an excerpt from an .lircrc file:\r
- <programlisting>\r
- begin geeqie\r
- begin\r
- prog = geeqie\r
- button = vol_up\r
- config = ZOOM_IN 1\r
- repeat = 3\r
- end\r
- </programlisting>\r
- </para>\r
- <para>The commands Geeqie will respond to are:</para>\r
- <table frame="all">\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <thead rowsep="1" colsep="1">\r
- <row>\r
- <entry>Command</entry>\r
- <entry>Mapped to</entry>\r
- </row>\r
- </thead>\r
- <tbody rowsep="1" colsep="1">\r
- <row>\r
- <entry>DOWN [int]</entry>\r
- <entry>Pan down by the specified amount. Default=1</entry>\r
- </row>\r
- <row>\r
- <entry>EXIT</entry>\r
- <entry>Exit Geeqie</entry>\r
- </row>\r
- <row>\r
- <entry>FIRST</entry>\r
- <entry>Jump to first image</entry>\r
- </row>\r
- <row>\r
- <entry>INFO</entry>\r
- <entry>Show image overlay (full screen only)</entry>\r
- </row>\r
- <row>\r
- <entry>LAST</entry>\r
- <entry>Jump to last image</entry>\r
- </row>\r
- <row>\r
- <entry>LEFT [int]</entry>\r
- <entry>Pan left by the specified amount. Default=1</entry>\r
- </row>\r
- <row>\r
- <entry>NEXT</entry>\r
- <entry>Go to next image</entry>\r
- </row>\r
- <row>\r
- <entry>PAUSE</entry>\r
- <entry>Pause/unpause slideshow</entry>\r
- </row>\r
- <row>\r
- <entry>PREV</entry>\r
- <entry>Go to previous image</entry>\r
- </row>\r
- <row>\r
- <entry>RIGHT [int]</entry>\r
- <entry>Pan right by the specified amount. Default=1</entry>\r
- </row>\r
- <row>\r
- <entry>ROTATE_90 ]</entry>\r
- <entry>Rotate image 90 degrees clockwise. .</entry>\r
- </row>\r
- <row>\r
- <entry>ROTATE_90_CC</entry>\r
- <entry>Rotate image 90 degrees counter-clockwise..</entry>\r
- </row>\r
- <row>\r
- <entry>SET_INV_ZOOM [int]</entry>\r
- <entry>Set Zoom level to 1:N. Default=1x</entry>\r
- </row>\r
- <row>\r
- <entry>SET_ZOOM [int]</entry>\r
- <entry>Set Zoom level to N:1. Default=1x</entry>\r
- </row>\r
- <row>\r
- <entry>UP [int]</entry>\r
- <entry>Pan up by the specified amount. Default=1</entry>\r
- </row>\r
- <row>\r
- <entry>ZOOM_IN [int]</entry>\r
- <entry>Zoom in. Value specifies the amount of zoom.</entry>\r
- </row>\r
- <row>\r
- <entry>ZOOM_MAX ]</entry>\r
- <entry>Zoom to fit image to window</entry>\r
- </row>\r
- <row>\r
- <entry>ZOOM_OUT [int]</entry>\r
- <entry>Zoom out. Value specifies the amount of zoom.</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <para />\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceLIRC">
+ <title id="titleGuideReferenceLIRC">Infra-red controller</title>
+ <para>Recent Linux kernels have in-built support for ir devices, making lirc support redundant.</para>
+ <para>If you wish to use lirc with Geeqie, the lirc libraries must be installed. If you are compiling from sources, lirc functionality will be available if the library dependencies are met.</para>
+ <para>If you are using a pre-compiled distribution, availability depends on the package maintainer.</para>
+ <para>
+ The website
+ <ulink url="http://www.lirc.org">Linux Infrared Remote Control</ulink>
+ has detailed information on this subject.
+ </para>
+ <para>
+ You will need to create a configuration file for the controller you will use. This file must be installed at the location specified in
+ <link linkend="GuideReferenceConfig" endterm="titleGuideReferenceConfig" />
+ .
+ </para>
+ <para>
+ Here is an excerpt from an .lircrc file:
+ <programlisting>
+ begin geeqie
+ begin
+ prog = geeqie
+ button = vol_up
+ config = ZOOM_IN 1
+ repeat = 3
+ end
+ </programlisting>
+ </para>
+ <para>The commands Geeqie will respond to are:</para>
+ <table frame="all">
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <thead rowsep="1" colsep="1">
+ <row>
+ <entry>Command</entry>
+ <entry>Mapped to</entry>
+ </row>
+ </thead>
+ <tbody rowsep="1" colsep="1">
+ <row>
+ <entry>DOWN [int]</entry>
+ <entry>Pan down by the specified amount. Default=1</entry>
+ </row>
+ <row>
+ <entry>EXIT</entry>
+ <entry>Exit Geeqie</entry>
+ </row>
+ <row>
+ <entry>FIRST</entry>
+ <entry>Jump to first image</entry>
+ </row>
+ <row>
+ <entry>INFO</entry>
+ <entry>Show image overlay (full screen only)</entry>
+ </row>
+ <row>
+ <entry>LAST</entry>
+ <entry>Jump to last image</entry>
+ </row>
+ <row>
+ <entry>LEFT [int]</entry>
+ <entry>Pan left by the specified amount. Default=1</entry>
+ </row>
+ <row>
+ <entry>NEXT</entry>
+ <entry>Go to next image</entry>
+ </row>
+ <row>
+ <entry>PAUSE</entry>
+ <entry>Pause/unpause slideshow</entry>
+ </row>
+ <row>
+ <entry>PREV</entry>
+ <entry>Go to previous image</entry>
+ </row>
+ <row>
+ <entry>RIGHT [int]</entry>
+ <entry>Pan right by the specified amount. Default=1</entry>
+ </row>
+ <row>
+ <entry>ROTATE_90 ]</entry>
+ <entry>Rotate image 90 degrees clockwise. .</entry>
+ </row>
+ <row>
+ <entry>ROTATE_90_CC</entry>
+ <entry>Rotate image 90 degrees counter-clockwise..</entry>
+ </row>
+ <row>
+ <entry>SET_INV_ZOOM [int]</entry>
+ <entry>Set Zoom level to 1:N. Default=1x</entry>
+ </row>
+ <row>
+ <entry>SET_ZOOM [int]</entry>
+ <entry>Set Zoom level to N:1. Default=1x</entry>
+ </row>
+ <row>
+ <entry>UP [int]</entry>
+ <entry>Pan up by the specified amount. Default=1</entry>
+ </row>
+ <row>
+ <entry>ZOOM_IN [int]</entry>
+ <entry>Zoom in. Value specifies the amount of zoom.</entry>
+ </row>
+ <row>
+ <entry>ZOOM_MAX ]</entry>
+ <entry>Zoom to fit image to window</entry>
+ </row>
+ <row>
+ <entry>ZOOM_OUT [int]</entry>
+ <entry>Zoom out. Value specifies the amount of zoom.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para />
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceLua">\r
- <title>Lua Extensions</title>\r
- <para>\r
- Lua scripts allow the functionality of Geeqie to be extended. Lua scripts may only be used in conjunction with the\r
- <link linkend="OverlayScreenDisplay">Overlay Screen Display</link>\r
- ,\r
- <link linkend="GuideSidebarsInfo" endterm="Listpanes-ExifFileinfoCopyrightLocationandGPS">List panes</link>\r
- on the Info Sidebar, and the\r
- <programlisting xml:space="preserve">geeqie --remote --lua:</programlisting>\r
- command line option.\r
- </para>\r
- <para />\r
- <para>Some knowledge of the Lua programming language is required.</para>\r
- <section id="Requirements">\r
- <title>Requirements</title>\r
- <para>Use of Lua within Geeqie requires Lua to be installed. If you are compiling from sources, Lua functionality will be available if the development files dependencies are met.</para>\r
- <para>If you are using a pre-compiled distribution, availability depends on the package maintainer.</para>\r
- </section>\r
- <section id="HowToUseLua">\r
- <title>How to use Lua</title>\r
- <para>\r
- Lua scripts must be stored in a single folder as defined in\r
- <link linkend="GuideReferenceConfig" endterm="titleGuideReferenceConfig" />\r
- .\r
- </para>\r
- <para>\r
- A link to a Lua script must be inserted into the overlay template. Refer to the\r
- <link linkend="OverlayScreenDisplay">Overlay Screen Display</link>\r
- section of Window Options.\r
- </para>\r
- <para>The full extent of the Lua language is available.</para>\r
- </section>\r
- <section id="GeeqieBuiltIn Functions">\r
- <title>Geeqie Lua built-in functions</title>\r
- <para>The following functions are built in to Geeqie:</para>\r
- <para>\r
- <informaltable>\r
- <tgroup cols="2">\r
- <tbody>\r
- <row>\r
- <entry>\r
- <emphasis role="strong">Function</emphasis>\r
- </entry>\r
- <entry>\r
- <emphasis role="strong">Returns</emphasis>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>Image:get_path()</entry>\r
- <entry>The full path of the file, including filename and extension</entry>\r
- </row>\r
- <row>\r
- <entry>Image:get_name()</entry>\r
- <entry>The full filename including extension</entry>\r
- </row>\r
- <row>\r
- <entry>Image:get_extension</entry>\r
- <entry>The file extension including preceding dot</entry>\r
- </row>\r
- <row>\r
- <entry>Image:get_date()</entry>\r
- <entry>The file date in Unix timestamp format.</entry>\r
- </row>\r
- <row>\r
- <entry>Image:get_size()</entry>\r
- <entry>The file size in bytes</entry>\r
- </row>\r
- <row>\r
- <entry>Image:get_marks()</entry>\r
- <entry>An integer representing the marks set for the file</entry>\r
- </row>\r
- <row>\r
- <entry>Image:get_exif()</entry>\r
- <entry>A data structure containing the entire exif data</entry>\r
- </row>\r
- <row>\r
- <entry><exif_str>:get_datum("<exif_tag>")</entry>\r
- <entry>A single exif tag extracted from a structure output by the above command</entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </informaltable>\r
- </para>\r
- <para>The keyword "Image" refers to the file currently being displayed by Geeqie.</para>\r
- </section>\r
- <section id="Examples">\r
- <title>Examples</title>\r
- <para>\r
- The following example, which outputs the jpeg comment of a file, demonstrates the use of a built-in function and how to call a system command from a Lua script:\r
- <programlisting xml:space="preserve">\r
- path=Image:get_path()\r
- commentfile=io.popen("exiv2 -p c \"" .. path .. "\"" )\r
- comment = commentfile:read("*a")\r
- commentfile:close()\r
- return (comment)\r
- </programlisting>\r
- </para>\r
- <para>Note that it is necessary to have escape characters surrounding path and filenames.</para>\r
- <para>\r
- The following example demonstrates how to extract exif data from a file:\r
- <programlisting xml:space="preserve">\r
- --Retrieve the DateTimeDigitized exif tag\r
- exif_structure = Image:get_exif();\r
- DateTimeDigitized = exif_structure:get_datum("Exif.Photo.DateTimeDigitized");\r
- return (os.date(DateTimeDigitized))\r
- </programlisting>\r
- </para>\r
- </section>\r
- <section id="Warning">\r
- <title>Warning</title>\r
- <warning>\r
- <para>Lua is a powerful programming language. Errors in script files, besides having undesirable side-effects, may cause Geeqie to crash.</para>\r
- </warning>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceLua">
+ <title>Lua Extensions</title>
+ <para>
+ Lua scripts allow the functionality of Geeqie to be extended. Lua scripts may only be used in conjunction with the
+ <link linkend="OverlayScreenDisplay">Overlay Screen Display</link>
+ ,
+ <link linkend="GuideSidebarsInfo" endterm="Listpanes-ExifFileinfoCopyrightLocationandGPS">List panes</link>
+ on the Info Sidebar, and the
+ <programlisting xml:space="preserve">geeqie --remote --lua:</programlisting>
+ command line option.
+ </para>
+ <para />
+ <para>Some knowledge of the Lua programming language is required.</para>
+ <section id="Requirements">
+ <title>Requirements</title>
+ <para>Use of Lua within Geeqie requires Lua to be installed. If you are compiling from sources, Lua functionality will be available if the development files dependencies are met.</para>
+ <para>If you are using a pre-compiled distribution, availability depends on the package maintainer.</para>
+ </section>
+ <section id="HowToUseLua">
+ <title>How to use Lua</title>
+ <para>
+ Lua scripts must be stored in a single folder as defined in
+ <link linkend="GuideReferenceConfig" endterm="titleGuideReferenceConfig" />
+ .
+ </para>
+ <para>
+ A link to a Lua script must be inserted into the overlay template. Refer to the
+ <link linkend="OverlayScreenDisplay">Overlay Screen Display</link>
+ section of Window Options.
+ </para>
+ <para>The full extent of the Lua language is available.</para>
+ </section>
+ <section id="GeeqieBuiltIn Functions">
+ <title>Geeqie Lua built-in functions</title>
+ <para>The following functions are built in to Geeqie:</para>
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>
+ <emphasis role="strong">Function</emphasis>
+ </entry>
+ <entry>
+ <emphasis role="strong">Returns</emphasis>
+ </entry>
+ </row>
+ <row>
+ <entry>Image:get_path()</entry>
+ <entry>The full path of the file, including filename and extension</entry>
+ </row>
+ <row>
+ <entry>Image:get_name()</entry>
+ <entry>The full filename including extension</entry>
+ </row>
+ <row>
+ <entry>Image:get_extension</entry>
+ <entry>The file extension including preceding dot</entry>
+ </row>
+ <row>
+ <entry>Image:get_date()</entry>
+ <entry>The file date in Unix timestamp format.</entry>
+ </row>
+ <row>
+ <entry>Image:get_size()</entry>
+ <entry>The file size in bytes</entry>
+ </row>
+ <row>
+ <entry>Image:get_marks()</entry>
+ <entry>An integer representing the marks set for the file</entry>
+ </row>
+ <row>
+ <entry>Image:get_exif()</entry>
+ <entry>A data structure containing the entire exif data</entry>
+ </row>
+ <row>
+ <entry><exif_str>:get_datum("<exif_tag>")</entry>
+ <entry>A single exif tag extracted from a structure output by the above command</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>The keyword "Image" refers to the file currently being displayed by Geeqie.</para>
+ </section>
+ <section id="Examples">
+ <title>Examples</title>
+ <para>
+ The following example, which outputs the jpeg comment of a file, demonstrates the use of a built-in function and how to call a system command from a Lua script:
+ <programlisting xml:space="preserve">
+ path=Image:get_path()
+ commentfile=io.popen("exiv2 -p c \"" .. path .. "\"" )
+ comment = commentfile:read("*a")
+ commentfile:close()
+ return (comment)
+ </programlisting>
+ </para>
+ <para>Note that it is necessary to have escape characters surrounding path and filenames.</para>
+ <para>
+ The following example demonstrates how to extract exif data from a file:
+ <programlisting xml:space="preserve">
+ --Retrieve the DateTimeDigitized exif tag
+ exif_structure = Image:get_exif();
+ DateTimeDigitized = exif_structure:get_datum("Exif.Photo.DateTimeDigitized");
+ return (os.date(DateTimeDigitized))
+ </programlisting>
+ </para>
+ </section>
+ <section id="Warning">
+ <title>Warning</title>
+ <warning>
+ <para>Lua is a powerful programming language. Errors in script files, besides having undesirable side-effects, may cause Geeqie to crash.</para>
+ </warning>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceLuaAPI">\r
- <title>Lua API</title>\r
- <para>\r
- <ulink url="./lua-api/html/lua_8c.html">The Lua API document</ulink>\r
- </para>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceLuaAPI">
+ <title>Lua API</title>
+ <para>
+ <ulink url="./lua-api/html/lua_8c.html">The Lua API document</ulink>
+ </para>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceManagement">\r
- <title id="titleGuideReferenceManagement">Cache and Data Maintenance</title>\r
- <para>\r
- Thumbnails and other cached data can be maintained from the dialog accessible by selecting\r
- <menuchoice>\r
- <guimenu>Edit</guimenu>\r
- <guimenuitem>Cache maintenance</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <para />\r
- <section id="Geeqiethumbnailcache">\r
- <title>Geeqie thumbnail and sim. cache</title>\r
- <para>\r
- The utilities listed here operate on the Geeqie caching mechanism. This also includes the data cached for the\r
- <link linkend="GuideImageSearchSearch">search</link>\r
- and\r
- <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>\r
- utilities.\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Clean up</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Removes thumbnails, sim. files, and data for which the source image is no longer present, or has been modified since the thumbnail was generated.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Clear cache</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Removes all thumbnails, sim. files, and data stored in the designated folder.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Sharedthumbnailcache">\r
- <title>Shared thumbnail cache</title>\r
- <para>The utilities listed here operate on the shared thumbnail mechanism.</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Clean up</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Clear cache</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Removes all thumbnails stored in the designated folder.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="Createthumbnails">\r
- <title>Create thumbnails</title>\r
- <para>\r
- This utility will render thumbnails using the current thumbnail caching mechanism, as determined in\r
- <link linkend="GuideOptionsGeneral">Preferences</link>\r
- .\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Render</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Pre-render thumbnails for a specific folder, the utility has the following options:</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Include subfolders</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Enable to include all images contained in the subfolders of folder.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Store thumbnails local to source images</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The generated thumbnails will be stored local to the source images, if you have the permissions to write to the folder containing the images.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="CreateSimFiles">\r
- <title>Create file similarity cache</title>\r
- <para>\r
- Some file operations, such as\r
- <link linkend="GuideImageSearchSearch">search</link>\r
- and\r
- <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>\r
- , are speeded up if similarity data files for the images have been created. This utility will create sim. files recursively under the specified folder.\r
- <para />\r
- The sim. files contain some or all of the following fields:\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Dimensions</guilabel>\r
- </term>\r
- <listitem>\r
- <para>width x height</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Date</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Exif date in time_t format</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>checksum</guilabel>\r
- </term>\r
- <listitem>\r
- <para>MD5sum 32 character ascii text digest</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>SimilarityGrid</guilabel>\r
- </term>\r
- <listitem>\r
- <para>[32 x 32] = 3072 bytes of data (1024 pixels in RGB format, 1 pixel is 24bits)</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </para>\r
- </section>\r
- <section id="Metadata">\r
- <title>Metadata</title>\r
- <para>\r
- This utility operates on the data store for\r
- <link linkend="MetadataWritingProcess">Metadata</link>\r
- located in the folder:\r
- <programlisting>$HOME/.local/share/Geeqie/metadata</programlisting>\r
- </para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Clean up</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Removes keywords and comments for which the source image is no longer present.</para>\r
- <para />\r
- <para />\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </section>\r
- <section id="BackgroundCacheMaintenance">\r
- <title>Background Cache Maintenance</title>\r
- <para>\r
- This facility will run the command line program described below as a stand-alone background job.\r
- </para>\r
- </section>\r
- <section id="CacheMaintenance">\r
- <title>Command line program</title>\r
- <para>\r
- Geeqie can be run as a command line program: <code>geeqie --cache-maintenance <path></code>. It will recursively remove orphaned thumbnails and .sim files, and create thumbnails and similarity data for all images found.\r
- <para/>\r
- It may also be called from <code>cron</code> or <code>anacron</code> thus enabling automatic updating of the cached data for all your images.\r
- </para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceManagement">
+ <title id="titleGuideReferenceManagement">Cache and Data Maintenance</title>
+ <para>
+ Thumbnails and other cached data can be maintained from the dialog accessible by selecting
+ <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Cache maintenance</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <para />
+ <section id="Geeqiethumbnailcache">
+ <title>Geeqie thumbnail and sim. cache</title>
+ <para>
+ The utilities listed here operate on the Geeqie caching mechanism. This also includes the data cached for the
+ <link linkend="GuideImageSearchSearch">search</link>
+ and
+ <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>
+ utilities.
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Clean up</guilabel>
+ </term>
+ <listitem>
+ <para>Removes thumbnails, sim. files, and data for which the source image is no longer present, or has been modified since the thumbnail was generated.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Clear cache</guilabel>
+ </term>
+ <listitem>
+ <para>Removes all thumbnails, sim. files, and data stored in the designated folder.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Sharedthumbnailcache">
+ <title>Shared thumbnail cache</title>
+ <para>The utilities listed here operate on the shared thumbnail mechanism.</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Clean up</guilabel>
+ </term>
+ <listitem>
+ <para>Removes thumbnails for which the source image is no longer present, or has been modified since the thumbnail was generated.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Clear cache</guilabel>
+ </term>
+ <listitem>
+ <para>Removes all thumbnails stored in the designated folder.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="Createthumbnails">
+ <title>Create thumbnails</title>
+ <para>
+ This utility will render thumbnails using the current thumbnail caching mechanism, as determined in
+ <link linkend="GuideOptionsGeneral">Preferences</link>
+ .
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Render</guilabel>
+ </term>
+ <listitem>
+ <para>Pre-render thumbnails for a specific folder, the utility has the following options:</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Include subfolders</guilabel>
+ </term>
+ <listitem>
+ <para>Enable to include all images contained in the subfolders of folder.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Store thumbnails local to source images</guilabel>
+ </term>
+ <listitem>
+ <para>The generated thumbnails will be stored local to the source images, if you have the permissions to write to the folder containing the images.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="CreateSimFiles">
+ <title>Create file similarity cache</title>
+ <para>
+ Some file operations, such as
+ <link linkend="GuideImageSearchSearch">search</link>
+ and
+ <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>
+ , are speeded up if similarity data files for the images have been created. This utility will create sim. files recursively under the specified folder.
+ <para />
+ The sim. files contain some or all of the following fields:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Dimensions</guilabel>
+ </term>
+ <listitem>
+ <para>width x height</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Date</guilabel>
+ </term>
+ <listitem>
+ <para>Exif date in time_t format</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>checksum</guilabel>
+ </term>
+ <listitem>
+ <para>MD5sum 32 character ascii text digest</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>SimilarityGrid</guilabel>
+ </term>
+ <listitem>
+ <para>[32 x 32] = 3072 bytes of data (1024 pixels in RGB format, 1 pixel is 24bits)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </section>
+ <section id="Metadata">
+ <title>Metadata</title>
+ <para>
+ This utility operates on the data store for
+ <link linkend="MetadataWritingProcess">Metadata</link>
+ located in the folder:
+ <programlisting>$HOME/.local/share/Geeqie/metadata</programlisting>
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Clean up</guilabel>
+ </term>
+ <listitem>
+ <para>Removes keywords and comments for which the source image is no longer present.</para>
+ <para />
+ <para />
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </section>
+ <section id="BackgroundCacheMaintenance">
+ <title>Background Cache Maintenance</title>
+ <para>
+ This facility will run the command line program described below as a stand-alone background job.
+ </para>
+ </section>
+ <section id="CacheMaintenance">
+ <title>Command line program</title>
+ <para>
+ Geeqie can be run as a command line program: <code>geeqie --cache-maintenance <path></code>. It will recursively remove orphaned thumbnails and .sim files, and create thumbnails and similarity data for all images found.
+ <para/>
+ It may also be called from <code>cron</code> or <code>anacron</code> thus enabling automatic updating of the cached data for all your images.
+ </para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceMetadata">\r
- <title id="titleGuideReferenceMetadata">Metadata Processing</title>\r
- <para>This section describes the metadata reading and writing process.</para>\r
- <para />\r
- <section id="Metadatahandling">\r
- <title>Metadata handling</title>\r
- <para />\r
- <section id="Readalgorithm">\r
- <title>Read algorithm</title>\r
- <orderedlist spacing="compact">\r
- <listitem>\r
- <para>Read Exif, IPTC and XMP from the file.</para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- Display this "raw" data in the\r
- <link linkend="GuideOtherWindowsExif">Exif Window</link>\r
- .\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>Read XMP sidecar or Geeqie private metadata file. This data will override the XMP data read from the file.</para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- Synchronise XMP data with Exif and IPTC data. This process corresponds to the section "Reconciling metadata properties" as described in the\r
- <link linkend="GuideReferenceStandards">XMP Specification</link>\r
- .\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>detect which of Exif and Xmp.exif is newer and copy the data in the appropriate direction</para>\r
- </listitem>\r
- <listitem>\r
- <para>detect which of IPTC and XMP is newer and copy the data in the appropriate direction</para>\r
- </listitem>\r
- </itemizedlist>\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- Use this "processed" data within Geeqie, with the exception of in the\r
- <link linkend="GuideOtherWindowsExif">Exif Window</link>\r
- </para>\r
- </listitem>\r
- </orderedlist>\r
- <para />\r
- </section>\r
- <section id="Metadatamodification">\r
- <title>Metadata modification</title>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>\r
- Metadata is written to a single file or group of files as specified in the\r
- <link linkend="MetadataMiscellaneous">Metadata</link>\r
- tab of main Preferences.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>Modifying the keywords, comment, orientation, etc. does not ask for confirmation, but immediately modifies the metadata in memory and adds the file to "write queue"</para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- Writing of the queued changes is triggered either\r
- <link linkend="Buttons">manually</link>\r
- or as defined in\r
- <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />. It is possible to review the changes and exclude selected files.\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- <para />\r
- </section>\r
- <section id="Writealgorithm">\r
- <title>Write algorithm</title>\r
- <orderedlist spacing="compact">\r
- <listitem>\r
- <para>\r
- Exif and IPTC are updated from XMP (for example\r
- <emphasis>Exif.Image.Orientation</emphasis>\r
- is updated from\r
- <emphasis>Xmp.exif.orientation</emphasis>\r
- ). See\r
- <link linkend="GuideReferenceStandards">XMP</link>\r
- and\r
- <link linkend="GuideReferenceStandards">IPTC4XMP</link>\r
- specifications for the list of corresponding tags.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- Try to write metadata in the order specified in the\r
- <link linkend="MetadataWritingProcess" endterm="titleMetadataWritingProcess" />\r
- section of Preferences.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>After the first successful write attempt delete old metadata files in all possible locations.</para>\r
- </listitem>\r
- </orderedlist>\r
- <para />\r
- </section>\r
- </section>\r
- <section id="Optionsthatinfluencestheprocess">\r
- <title>Options that influence the process</title>\r
- <para>\r
- File types with allowed sidecars are listed in the\r
- <link linkend="GuideOptionsFiltering" endterm="titleGuideOptionsFiltering" />\r
- tab of the main Preferences.\r
- </para>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceMetadata">
+ <title id="titleGuideReferenceMetadata">Metadata Processing</title>
+ <para>This section describes the metadata reading and writing process.</para>
+ <para />
+ <section id="Metadatahandling">
+ <title>Metadata handling</title>
+ <para />
+ <section id="Readalgorithm">
+ <title>Read algorithm</title>
+ <orderedlist spacing="compact">
+ <listitem>
+ <para>Read Exif, IPTC and XMP from the file.</para>
+ </listitem>
+ <listitem>
+ <para>
+ Display this "raw" data in the
+ <link linkend="GuideOtherWindowsExif">Exif Window</link>
+ .
+ </para>
+ </listitem>
+ <listitem>
+ <para>Read XMP sidecar or Geeqie private metadata file. This data will override the XMP data read from the file.</para>
+ </listitem>
+ <listitem>
+ <para>
+ Synchronise XMP data with Exif and IPTC data. This process corresponds to the section "Reconciling metadata properties" as described in the
+ <link linkend="GuideReferenceStandards">XMP Specification</link>
+ .
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>detect which of Exif and Xmp.exif is newer and copy the data in the appropriate direction</para>
+ </listitem>
+ <listitem>
+ <para>detect which of IPTC and XMP is newer and copy the data in the appropriate direction</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Use this "processed" data within Geeqie, with the exception of in the
+ <link linkend="GuideOtherWindowsExif">Exif Window</link>
+ </para>
+ </listitem>
+ </orderedlist>
+ <para />
+ </section>
+ <section id="Metadatamodification">
+ <title>Metadata modification</title>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Metadata is written to a single file or group of files as specified in the
+ <link linkend="MetadataMiscellaneous">Metadata</link>
+ tab of main Preferences.
+ </para>
+ </listitem>
+ <listitem>
+ <para>Modifying the keywords, comment, orientation, etc. does not ask for confirmation, but immediately modifies the metadata in memory and adds the file to "write queue"</para>
+ </listitem>
+ <listitem>
+ <para>
+ Writing of the queued changes is triggered either
+ <link linkend="Buttons">manually</link>
+ or as defined in
+ <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />. It is possible to review the changes and exclude selected files.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para />
+ </section>
+ <section id="Writealgorithm">
+ <title>Write algorithm</title>
+ <orderedlist spacing="compact">
+ <listitem>
+ <para>
+ Exif and IPTC are updated from XMP (for example
+ <emphasis>Exif.Image.Orientation</emphasis>
+ is updated from
+ <emphasis>Xmp.exif.orientation</emphasis>
+ ). See
+ <link linkend="GuideReferenceStandards">XMP</link>
+ and
+ <link linkend="GuideReferenceStandards">IPTC4XMP</link>
+ specifications for the list of corresponding tags.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Try to write metadata in the order specified in the
+ <link linkend="MetadataWritingProcess" endterm="titleMetadataWritingProcess" />
+ section of Preferences.
+ </para>
+ </listitem>
+ <listitem>
+ <para>After the first successful write attempt delete old metadata files in all possible locations.</para>
+ </listitem>
+ </orderedlist>
+ <para />
+ </section>
+ </section>
+ <section id="Optionsthatinfluencestheprocess">
+ <title>Options that influence the process</title>
+ <para>
+ File types with allowed sidecars are listed in the
+ <link linkend="GuideOptionsFiltering" endterm="titleGuideOptionsFiltering" />
+ tab of the main Preferences.
+ </para>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferencePCRE">\r
- <title id="titleGuideReferencePCRE">Perl Compatible Regular Expressions</title>\r
- <para>\r
- The Filename and Comment sections on the search window use\r
- <ulink url="https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions">Perl Compatible Regular Expressions</ulink>\r
- . In general use there are a number of differences to the wildcard expansion used on the command line:\r
- <itemizedlist>\r
- <listitem>Use "." and not "?" for a single character.</listitem>\r
- <listitem>Use "abc.*ghk" and not "abc*ghk" for multiple characters</listitem>\r
- <listitem>Use "\." to represent the dot in a file extension</listitem>\r
- <listitem>Use "(?i)" to make the following characters case-insensitive</listitem>\r
- </itemizedlist>\r
- </para>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferencePCRE">
+ <title id="titleGuideReferencePCRE">Perl Compatible Regular Expressions</title>
+ <para>
+ The Filename and Comment sections on the search window use
+ <ulink url="https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions">Perl Compatible Regular Expressions</ulink>
+ . In general use there are a number of differences to the wildcard expansion used on the command line:
+ <itemizedlist>
+ <listitem>Use "." and not "?" for a single character.</listitem>
+ <listitem>Use "abc.*ghk" and not "abc*ghk" for multiple characters</listitem>
+ <listitem>Use "\." to represent the dot in a file extension</listitem>
+ <listitem>Use "(?i)" to make the following characters case-insensitive</listitem>
+ </itemizedlist>
+ </para>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferencePixbufLoaders">\r
- <title id="titleGuideReferencePixbufLoaders">Additional pixbuf loaders</title>\r
- <para>Geeqie can display files for which there are existing pixbuf loaders. In addition to the standard ones included with most distributions, the following loaders may also be available to you.</para>\r
- <para>However, in some cases you are required to compile and install them yourself.</para>\r
- <section id="jp2">\r
- <title>JP2/JPC/JPX/J2K/JPF</title>\r
- <para>If your distribution has the libpixbufloader-jasper.so loader, these file formats will also be displayed.</para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferencePixbufLoaders">
+ <title id="titleGuideReferencePixbufLoaders">Additional pixbuf loaders</title>
+ <para>Geeqie can display files for which there are existing pixbuf loaders. In addition to the standard ones included with most distributions, the following loaders may also be available to you.</para>
+ <para>However, in some cases you are required to compile and install them yourself.</para>
+ <section id="jp2">
+ <title>JP2/JPC/JPX/J2K/JPF</title>
+ <para>If your distribution has the libpixbufloader-jasper.so loader, these file formats will also be displayed.</para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceStandardPlugins">\r
- <title id="titleGuideReferenceStandardPlugins">Standard Plugins</title>\r
- <para>The following plugins are supplied as standard with Geeqie.</para>\r
- <section id="EditUFRawIDfile">\r
- <title>Edit UFRaw ID file</title>\r
- <para>Creates a UFRaw ID file for each of the selected files.</para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Edit</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="UFRawBatch">\r
- <title>UFRaw Batch</title>\r
- <para>\r
- Searches for new RAW files or for modified UFRaw \r
- ID files and processes them with\r
- <code>ufraw-batch</code>\r
- .\r
- </para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Edit</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="UFRawBatchrecursive">\r
- <title>UFRaw Batch recursive</title>\r
- <para>As above, with a recursive search.</para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Edit</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="Symlink">\r
- <title>Symlink</title>\r
- <para>Creates a symbolic link on the selected files. If a file has sidecars, they will also be symlinked.</para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">File</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="Applytheorientationtoimagecontent">\r
- <title>Apply the orientation to image content</title>\r
- <para>This command affects only jpeg, tiff and png files. The image file on disk is rotated to the orientation as specified by its Exif Orientation tag.</para>\r
- <warning>\r
- <para>External commands exiftran, exiv2 and mogrify, are used to implement this command.</para>\r
- </warning>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Edit/Orientation</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="Cameraimport">\r
- <title>Camera import</title>\r
- <para>Imports images from an attached camera to the current folder. If a file with the same name already exists it will not be overwritten, and the new image will not be downloaded.</para>\r
- <para>File names on digital cameras are not necessarily unique. In some cases the same file name can exist in more than one sub-folder on the camera. As existing images will not be overwritten, subsequent files of the same name will not be downloaded. In this case a dialog will be shown to warn you of this.</para>\r
- <para>\r
- You may use the gphoto2 option\r
- <code>--filename</code>\r
- option to ensure that all filenames are unique when downloading. Refer to the\r
- <ulink url="http://www.gphoto.org/doc/manual/ref-gphoto2-cli.html">gphoto2 documentation.</ulink>\r
- </para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Plugins</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="Exportjpeg">\r
- <title>Export jpeg</title>\r
- <para>\r
- Extracts an embedded jpeg from a raw image to a file in the\r
- <code>/tmp</code>\r
- folder. If you wish to to keep this image, it must be copied or moved.\r
- <para />\r
- If\r
- <code>jpgicc</code>\r
- is installed, the image will be colour-corrected for the currently selected rendering intent.\r
- </para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Plugins</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="Imagecrop">\r
- <title>Image crop</title>\r
- <para>\r
- If rectangle coordinates have been set by\r
- <emphasis role="strong">Edit/Draw Rectangle</emphasis>\r
- , a cropped image will be stored in the\r
- <code>/tmp</code>\r
- folder. If you wish to to keep this image, it must be copied or moved.\r
- </para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Plugins</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="Randomimage">\r
- <title>Random image</title>\r
- <para>Selects and displays a random image from a list of all images in Collections and the currently displayed folder.</para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Plugins</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
- <section id="Tetheredphotography">\r
- <title>Tethered photography</title>\r
- <para>\r
- If a camera is connected to the computer via USB, photos taken are immediately downloaded to the current folder and displayed on the computer.\r
- <para />\r
- If a file already exists with the same name, it is not overwritten but the download will not take place.\r
- <para />\r
- Auto-rename can be achieved with the --filename option of gphoto2.\r
- <para />\r
- In file\r
- <code>$HOME/.config/gphoto2/settings</code>\r
- , set the option:\r
- <code>gphoto2=filename=<see the gphoto2 manual></code>\r
- </para>\r
- <para>\r
- This item is displayed in the\r
- <emphasis role="strong">Plugins</emphasis>\r
- menu.\r
- </para>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceStandardPlugins">
+ <title id="titleGuideReferenceStandardPlugins">Standard Plugins</title>
+ <para>The following plugins are supplied as standard with Geeqie.</para>
+ <section id="EditUFRawIDfile">
+ <title>Edit UFRaw ID file</title>
+ <para>Creates a UFRaw ID file for each of the selected files.</para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Edit</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="UFRawBatch">
+ <title>UFRaw Batch</title>
+ <para>
+ Searches for new RAW files or for modified UFRaw
+ ID files and processes them with
+ <code>ufraw-batch</code>
+ .
+ </para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Edit</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="UFRawBatchrecursive">
+ <title>UFRaw Batch recursive</title>
+ <para>As above, with a recursive search.</para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Edit</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="Symlink">
+ <title>Symlink</title>
+ <para>Creates a symbolic link on the selected files. If a file has sidecars, they will also be symlinked.</para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">File</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="Applytheorientationtoimagecontent">
+ <title>Apply the orientation to image content</title>
+ <para>This command affects only jpeg, tiff and png files. The image file on disk is rotated to the orientation as specified by its Exif Orientation tag.</para>
+ <warning>
+ <para>External commands exiftran, exiv2 and mogrify, are used to implement this command.</para>
+ </warning>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Edit/Orientation</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="Cameraimport">
+ <title>Camera import</title>
+ <para>Imports images from an attached camera to the current folder. If a file with the same name already exists it will not be overwritten, and the new image will not be downloaded.</para>
+ <para>File names on digital cameras are not necessarily unique. In some cases the same file name can exist in more than one sub-folder on the camera. As existing images will not be overwritten, subsequent files of the same name will not be downloaded. In this case a dialog will be shown to warn you of this.</para>
+ <para>
+ You may use the gphoto2 option
+ <code>--filename</code>
+ option to ensure that all filenames are unique when downloading. Refer to the
+ <ulink url="http://www.gphoto.org/doc/manual/ref-gphoto2-cli.html">gphoto2 documentation.</ulink>
+ </para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Plugins</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="Exportjpeg">
+ <title>Export jpeg</title>
+ <para>
+ Extracts an embedded jpeg from a raw image to a file in the
+ <code>/tmp</code>
+ folder. If you wish to to keep this image, it must be copied or moved.
+ <para />
+ If
+ <code>jpgicc</code>
+ is installed, the image will be colour-corrected for the currently selected rendering intent.
+ </para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Plugins</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="Imagecrop">
+ <title>Image crop</title>
+ <para>
+ If rectangle coordinates have been set by
+ <emphasis role="strong">Edit/Draw Rectangle</emphasis>
+ , a cropped image will be stored in the
+ <code>/tmp</code>
+ folder. If you wish to to keep this image, it must be copied or moved.
+ </para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Plugins</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="Randomimage">
+ <title>Random image</title>
+ <para>Selects and displays a random image from a list of all images in Collections and the currently displayed folder.</para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Plugins</emphasis>
+ menu.
+ </para>
+ </section>
+ <section id="Tetheredphotography">
+ <title>Tethered photography</title>
+ <para>
+ If a camera is connected to the computer via USB, photos taken are immediately downloaded to the current folder and displayed on the computer.
+ <para />
+ If a file already exists with the same name, it is not overwritten but the download will not take place.
+ <para />
+ Auto-rename can be achieved with the --filename option of gphoto2.
+ <para />
+ In file
+ <code>$HOME/.config/gphoto2/settings</code>
+ , set the option:
+ <code>gphoto2=filename=<see the gphoto2 manual></code>
+ </para>
+ <para>
+ This item is displayed in the
+ <emphasis role="strong">Plugins</emphasis>
+ menu.
+ </para>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceStandards">\r
- <title id="titleGuideReferenceStandards">Standards</title>\r
- <para>\r
- Desktop files:\r
- <ulink url="https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html">https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html</ulink>\r
- </para>\r
- <para>\r
- Desktop files:\r
- <ulink url="http://standards.freedesktop.org/desktop-entry-spec/">http://standards.freedesktop.org/desktop-entry-spec/</ulink>\r
- </para>\r
- <para>\r
- XMP:\r
- <ulink url="https://wwwimages2.adobe.com/content/dam/acom/en/devnet/xmp/pdfs/XMP%20SDK%20Release%20cc-2016-08/XMPSpecificationPart3.pdf" />\r
- </para>\r
- <para>\r
- IPTC4XMP:\r
- <ulink url="http://xml.coverpages.org/IPTC-CoreSchema200503-ImplGuideLines3.pdf" />\r
- </para>\r
- <para>\r
- Pango mark up:\r
- <ulink url="https://developer.gnome.org/pygtk/stable/pango-markup-language.html" />\r
- </para>\r
- <para>\r
- Thumbnails:\r
- <ulink url="https://specifications.freedesktop.org/thumbnail-spec/thumbnail-spec-latest.html" />\r
- </para>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceStandards">
+ <title id="titleGuideReferenceStandards">Standards</title>
+ <para>
+ Desktop files:
+ <ulink url="https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html">https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html</ulink>
+ </para>
+ <para>
+ Desktop files:
+ <ulink url="http://standards.freedesktop.org/desktop-entry-spec/">http://standards.freedesktop.org/desktop-entry-spec/</ulink>
+ </para>
+ <para>
+ XMP:
+ <ulink url="https://wwwimages2.adobe.com/content/dam/acom/en/devnet/xmp/pdfs/XMP%20SDK%20Release%20cc-2016-08/XMPSpecificationPart3.pdf" />
+ </para>
+ <para>
+ IPTC4XMP:
+ <ulink url="http://xml.coverpages.org/IPTC-CoreSchema200503-ImplGuideLines3.pdf" />
+ </para>
+ <para>
+ Pango mark up:
+ <ulink url="https://developer.gnome.org/pygtk/stable/pango-markup-language.html" />
+ </para>
+ <para>
+ Thumbnails:
+ <ulink url="https://specifications.freedesktop.org/thumbnail-spec/thumbnail-spec-latest.html" />
+ </para>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceSupportedFormats">\r
- <title id="titleGuideReferenceSupportedFormats">Supported File Formats</title>\r
- <para>3FR, ANI, APM, ARW, BMP, CR2, CRW, CUR, DDS, DNG, ERF, GIF, ICNS, ICO, JPE/JPEG/JPG, JPS, KDC, MEF, MPO, MOS, MRW, NEF, ORF, PEF, PTX, PBM/PGM/PNM/PPM, PNG, QIF/QTIF (QuickTime Image Format), RAF, RAW, RW2, SR2, SRF, SVG/SVGZ, TGA/TARGA, TIF/TIFF, WMF, XBM, XPM, HEIF (primary image only), WebP, DjVu.</para>\r
- <para>Images in archive files (.zip, .tar etc) can be displayed.\r
- </para>\r
- <para>Animated GIFs are supported.\r
- </para>\r
- <para>\r
- Refer to\r
- <link linkend="GuideReferencePixbufLoaders" endterm="titleGuideReferencePixbufLoaders" />\r
- for additional information.\r
- </para>\r
- <para>\r
- Preview and thumbnails of video clips can be displayed. Clips can be run via a defined external program - see\r
- <link linkend="Behaviour">Play video by left click on image</link>\r
- .\r
- </para>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceSupportedFormats">
+ <title id="titleGuideReferenceSupportedFormats">Supported File Formats</title>
+ <para>3FR, ANI, APM, ARW, BMP, CR2, CRW, CUR, DDS, DNG, ERF, GIF, ICNS, ICO, JPE/JPEG/JPG, JPS, KDC, MEF, MPO, MOS, MRW, NEF, ORF, PEF, PTX, PBM/PGM/PNM/PPM, PNG, QIF/QTIF (QuickTime Image Format), RAF, RAW, RW2, SR2, SRF, SVG/SVGZ, TGA/TARGA, TIF/TIFF, WMF, XBM, XPM, HEIF (primary image only), WebP, DjVu.</para>
+ <para>Images in archive files (.zip, .tar etc) can be displayed.
+ </para>
+ <para>Animated GIFs are supported.
+ </para>
+ <para>
+ Refer to
+ <link linkend="GuideReferencePixbufLoaders" endterm="titleGuideReferencePixbufLoaders" />
+ for additional information.
+ </para>
+ <para>
+ Preview and thumbnails of video clips can be displayed. Clips can be run via a defined external program - see
+ <link linkend="Behaviour">Play video by left click on image</link>
+ .
+ </para>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceXmpExif">\r
- <title id="titleGuideReferenceXmpExif">XMP, Exif and IPTC</title>\r
- <para>The tables below show the XMP, Exif and IPTC tags used by Geeqie.</para>\r
- <section id="preformatted">\r
- <title>Geeqie pre-formatted tags</title>\r
- <table frame="all">\r
- <title>Pre-formatted tags</title>\r
- <tgroup cols="3" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>\r
- <para>Geeqie Tag</para>\r
- </entry>\r
- <entry>\r
- <para>Exif tags used</para>\r
- </entry>\r
- <entry>\r
- <para>Description</para>\r
- </entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <para>formatted.Camera</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.Image.Make\r
- <para />\r
- Exif.Image.Model\r
- <para />\r
- Exif.Image.Software\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Camera and software name</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.DateTime</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.Photo.DateTimeOriginal\r
- <para />\r
- Exif.Photo.SubSecTimeOriginal\r
- <para />\r
- Exif.Image.DateTime\r
- <para />\r
- Exif.Photo.SubSecTime\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Image Date</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.ShutterSpeed</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.Photo.ExposureTime\r
- <para />\r
- Exif.Photo.ShutterSpeedValue\r
-\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Shutter speed in seconds (e.g. 1/60s)</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.Aperture</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- <para>\r
- Exif.Photo.Fnumber\r
- <para />\r
- Exif.Photo.ApertureValue\r
- </para>\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Aperture (e.g. f5.6)</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.ExposureBias</para>\r
- </entry>\r
- <entry>\r
- <para>Exif.Photo.ExposureBiasValue</para>\r
- </entry>\r
- <entry>\r
- <para>Exposure bias (e.g. +0.3)</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.ISOSpeedRating</para>\r
- </entry>\r
- <entry>\r
- <para>Exif.Photo.ISOSpeedRatings</para>\r
- </entry>\r
- <entry>\r
- <para>ISO sensitivity (e.g. 100)</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.FocalLength</para>\r
- </entry>\r
- <entry>\r
- <para>Exif.Photo.FocalLength</para>\r
- </entry>\r
- <entry>\r
- <para>Focal length</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.FocalLength35mmFilm</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.Photo.FocalLengthIn35mmFilm\r
- <para />\r
- Exif.Photo.FocalLength\r
- <para />\r
- Exif.Photo.FocalPlaneXResolution\r
- <para />\r
- Exif.Photo.FocalPlaneYResolution\r
- <para />\r
- Exif.Photo.FocalPlaneResolutionUnit\r
- <para />\r
- Exif.Photo.PixelXDimension\r
- <para />\r
- Exif.Photo.PixelYDimension\r
-\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Focal length 35mm</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.SubjectDistance</para>\r
- </entry>\r
- <entry>\r
- <para>Exif.Photo.SubjectDistance</para>\r
- </entry>\r
- <entry>\r
- <para>Subject distance</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.Flash</para>\r
- </entry>\r
- <entry>\r
- <para>Exif.Photo.Flash</para>\r
- </entry>\r
- <entry>\r
- <para>Flash</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.Resolution</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.Image.Xresolution\r
- <para />\r
- Exif.Image.Yresolution\r
- <para />\r
- Exif.Image.ResolutionUnit\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Resolution</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.ColorProfile</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.Image.InterColorProfile\r
- <para />\r
- Exif.Photo.ColorSpace\r
- <para />\r
- Exif.Iop.InteroperabilityIndex\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Color profile</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.GPSAltitude</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.GPSInfo.GPSAltitudeRef\r
- <para />\r
- Exif.GPSInfo.GPSAltitude\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Altitude above sea level</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.GPSPosition</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.GPSInfo.GPSLatitude\r
- <para />\r
- Exif.GPSInfo.GPSLatitudeRef\r
- <para />\r
- Exif.GPSInfo.GPSLongitude\r
- <para />\r
- Exif.GPSInfo.GPSLongitudeRef\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Latitude, Longitude</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.localtime</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.GPSInfo.GPSLatitude\r
- <para />\r
- Exif.GPSInfo.GPSLatitudeRef\r
- <para />\r
- Exif.GPSInfo.GPSLongitude\r
- <para />\r
- Exif.GPSInfo.GPSLongitudeRef\r
- <para />\r
- Exif.GPSInfo.GPSDateStamp\r
- <para />\r
- Exif.GPSInfo.GPSTimeStamp\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Local time corrected for UTC offset, DST correction\r
- <footnote id='ref1'>\r
- <para>\r
- Refer to\r
- <link linkend="GuideReferenceUTC">UTC and DST</link>\r
- section.\r
- </para>\r
- </footnote>\r
- </para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.timezone</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.GPSInfo.GPSLatitude\r
- <para />\r
- Exif.GPSInfo.GPSLatitudeRef\r
- <para />\r
- Exif.GPSInfo.GPSLongitude\r
- <para />\r
- Exif.GPSInfo.GPSLongitudeRef\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Timezone indicated by lat/long\r
- <footnote id='ref1'>\r
- <para>\r
- Refer to\r
- <link linkend="GuideReferenceUTC">UTC and DST</link>\r
- section.\r
- </para>\r
- </footnote>\r
- </para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.countryname</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.GPSInfo.GPSLatitude\r
- <para />\r
- Exif.GPSInfo.GPSLatitudeRef\r
- <para />\r
- Exif.GPSInfo.GPSLongitude\r
- <para />\r
- Exif.GPSInfo.GPSLongitudeRef\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>ISO 3166 country name indicated by lat/long</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.countrycode</para>\r
- </entry>\r
- <entry>\r
- <para>\r
- Exif.GPSInfo.GPSLatitude\r
- <para />\r
- Exif.GPSInfo.GPSLatitudeRef\r
- <para />\r
- Exif.GPSInfo.GPSLongitude\r
- <para />\r
- Exif.GPSInfo.GPSLongitudeRef\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>ISO 3166 two-letter abbreviated country name indicated by lat/long</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.star_rating</para>\r
- </entry>\r
- <entry>\r
- <para>Xmp.xmp.Rating</para>\r
- </entry>\r
- <entry>\r
- <para>Rating shown as a set of 🟊 characters</para>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
- <section id="infosidebar">\r
- <title>Info sidebar panes</title>\r
- <table frame="all">\r
- <title>Fixed panes</title>\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>\r
- <para>Tag</para>\r
- </entry>\r
- <entry>\r
- <para>Pane title</para>\r
- </entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.description</para>\r
- </entry>\r
- <entry>\r
- <para>Comment</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.subject</para>\r
- </entry>\r
- <entry>\r
- <para>Keywords</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.title</para>\r
- </entry>\r
- <entry>\r
- <para>Title</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.xmp.Rating</para>\r
- </entry>\r
- <entry>\r
- <para>Rating</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Headline</para>\r
- </entry>\r
- <entry>\r
- <para>Headline</para>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <table frame="all">\r
- <title>Location and GPS pane</title>\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>\r
- <para>Tag</para>\r
- </entry>\r
- <entry>\r
- <para>Field</para>\r
- </entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <para>formatted.GPSPosition</para>\r
- </entry>\r
- <entry>\r
- <para>GPS position</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.GPSAltitude</para>\r
- </entry>\r
- <entry>\r
- <para>GPS altitiude</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.timezone</para>\r
- </entry>\r
- <entry>\r
- <para>Time zone</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Country</para>\r
- </entry>\r
- <entry>\r
- <para>Country</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>\r
- <para>Xmp.iptc.CountryCode</para>\r
- </para>\r
- </entry>\r
- <entry>\r
- <para>Country Code</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.State</para>\r
- </entry>\r
- <entry>\r
- <para>State</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.City</para>\r
- </entry>\r
- <entry>\r
- <para>City</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.iptc.Location</para>\r
- </entry>\r
- <entry>\r
- <para>Location</para>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <table frame="all">\r
- <title>Copyright pane</title>\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>\r
- <para>Tag</para>\r
- </entry>\r
- <entry>\r
- <para>Field</para>\r
- </entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.creator</para>\r
- </entry>\r
- <entry>\r
- <para>Creator</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.contributor</para>\r
- </entry>\r
- <entry>\r
- <para>Contributor</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.rights</para>\r
- </entry>\r
- <entry>\r
- <para>Rights</para>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <table frame="all">\r
- <title>Exif pane</title>\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>\r
- <para>Tag</para>\r
- </entry>\r
- <entry>\r
- <para>Field</para>\r
- </entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <para>formatted.Camera</para>\r
- </entry>\r
- <entry>\r
- <para>Camera</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.DateTime</para>\r
- </entry>\r
- <entry>\r
- <para>Date</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.localtime</para>\r
- </entry>\r
- <entry>\r
- <para>Local time</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.ShutterSpeed</para>\r
- </entry>\r
- <entry>\r
- <para>Shutter speed</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.Aperture</para>\r
- </entry>\r
- <entry>\r
- <para>Aperture</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.ExposureBias</para>\r
- </entry>\r
- <entry>\r
- <para>Exposure bias</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.ISOSpeedRating</para>\r
- </entry>\r
- <entry>\r
- <para>ISO sensitivity</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.FocalLength</para>\r
- </entry>\r
- <entry>\r
- <para>Focal length</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.FocalLength35mmFilm</para>\r
- </entry>\r
- <entry>\r
- <para>Focal length 35mm</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.SubjectDistance</para>\r
- </entry>\r
- <entry>\r
- <para>Subject distance</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.Flash</para>\r
- </entry>\r
- <entry>\r
- <para>Flash</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.Resolution</para>\r
- </entry>\r
- <entry>\r
- <para>Resolution</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>formatted.ColorProfile</para>\r
- </entry>\r
- <entry>\r
- <para>Color profile</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Exif.Photo.ExposureProgram</para>\r
- </entry>\r
- <entry>\r
- <para>Exposure Program</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Exif.Photo.MeteringMode</para>\r
- </entry>\r
- <entry>\r
- <para>Metering Mode</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Exif.Photo.LightSource</para>\r
- </entry>\r
- <entry>\r
- <para>Light Source</para>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
- <section id="exifiptc">\r
- <title>Exif IPTC alternative keys</title>\r
- <table frame="all">\r
- <title>Conversion table</title>\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <thead>\r
- <row>\r
- <entry>\r
- <para>Tag</para>\r
- </entry>\r
- <entry>\r
- <para>Field</para>\r
- </entry>\r
- </row>\r
- </thead>\r
- <tbody>\r
- <row>\r
- <entry>\r
- <para>Xmp.tiff.Orientation</para>\r
- </entry>\r
- <entry>\r
- <para>Exif.Image.Orientation</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.title</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.ObjectName</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Urgency</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Urgency</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Category</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Category</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.SupplementalCategory</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.SuppCategory</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.subject</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Keywords</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.iptc.Location</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.LocationName</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Instruction</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.SpecialInstructions</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.DateCreated</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.DateCreated</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.creator</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Byline</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.AuthorsPosition</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.BylineTitle</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.City</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.City</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.State</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.ProvinceState</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.iptc.CountryCode</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.CountryCode</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Country</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.CountryName</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.TransmissionReference</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.TransmissionReference</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Headline</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Headline</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Credit</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Credit</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.Source</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Source</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.rights</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Copyright</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.dc.description</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Caption</para>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>\r
- <para>Xmp.photoshop.CaptionWriter</para>\r
- </entry>\r
- <entry>\r
- <para>Iptc.Application2.Writer</para>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceXmpExif">
+ <title id="titleGuideReferenceXmpExif">XMP, Exif and IPTC</title>
+ <para>The tables below show the XMP, Exif and IPTC tags used by Geeqie.</para>
+ <section id="preformatted">
+ <title>Geeqie pre-formatted tags</title>
+ <table frame="all">
+ <title>Pre-formatted tags</title>
+ <tgroup cols="3" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>Geeqie Tag</para>
+ </entry>
+ <entry>
+ <para>Exif tags used</para>
+ </entry>
+ <entry>
+ <para>Description</para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>formatted.Camera</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.Image.Make
+ <para />
+ Exif.Image.Model
+ <para />
+ Exif.Image.Software
+ </para>
+ </entry>
+ <entry>
+ <para>Camera and software name</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.DateTime</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.Photo.DateTimeOriginal
+ <para />
+ Exif.Photo.SubSecTimeOriginal
+ <para />
+ Exif.Image.DateTime
+ <para />
+ Exif.Photo.SubSecTime
+ </para>
+ </entry>
+ <entry>
+ <para>Image Date</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.ShutterSpeed</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.Photo.ExposureTime
+ <para />
+ Exif.Photo.ShutterSpeedValue
+
+ </para>
+ </entry>
+ <entry>
+ <para>Shutter speed in seconds (e.g. 1/60s)</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.Aperture</para>
+ </entry>
+ <entry>
+ <para>
+ <para>
+ Exif.Photo.Fnumber
+ <para />
+ Exif.Photo.ApertureValue
+ </para>
+ </para>
+ </entry>
+ <entry>
+ <para>Aperture (e.g. f5.6)</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.ExposureBias</para>
+ </entry>
+ <entry>
+ <para>Exif.Photo.ExposureBiasValue</para>
+ </entry>
+ <entry>
+ <para>Exposure bias (e.g. +0.3)</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.ISOSpeedRating</para>
+ </entry>
+ <entry>
+ <para>Exif.Photo.ISOSpeedRatings</para>
+ </entry>
+ <entry>
+ <para>ISO sensitivity (e.g. 100)</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.FocalLength</para>
+ </entry>
+ <entry>
+ <para>Exif.Photo.FocalLength</para>
+ </entry>
+ <entry>
+ <para>Focal length</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.FocalLength35mmFilm</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.Photo.FocalLengthIn35mmFilm
+ <para />
+ Exif.Photo.FocalLength
+ <para />
+ Exif.Photo.FocalPlaneXResolution
+ <para />
+ Exif.Photo.FocalPlaneYResolution
+ <para />
+ Exif.Photo.FocalPlaneResolutionUnit
+ <para />
+ Exif.Photo.PixelXDimension
+ <para />
+ Exif.Photo.PixelYDimension
+
+ </para>
+ </entry>
+ <entry>
+ <para>Focal length 35mm</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.SubjectDistance</para>
+ </entry>
+ <entry>
+ <para>Exif.Photo.SubjectDistance</para>
+ </entry>
+ <entry>
+ <para>Subject distance</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.Flash</para>
+ </entry>
+ <entry>
+ <para>Exif.Photo.Flash</para>
+ </entry>
+ <entry>
+ <para>Flash</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.Resolution</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.Image.Xresolution
+ <para />
+ Exif.Image.Yresolution
+ <para />
+ Exif.Image.ResolutionUnit
+ </para>
+ </entry>
+ <entry>
+ <para>Resolution</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.ColorProfile</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.Image.InterColorProfile
+ <para />
+ Exif.Photo.ColorSpace
+ <para />
+ Exif.Iop.InteroperabilityIndex
+ </para>
+ </entry>
+ <entry>
+ <para>Color profile</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.GPSAltitude</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.GPSInfo.GPSAltitudeRef
+ <para />
+ Exif.GPSInfo.GPSAltitude
+ </para>
+ </entry>
+ <entry>
+ <para>Altitude above sea level</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.GPSPosition</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.GPSInfo.GPSLatitude
+ <para />
+ Exif.GPSInfo.GPSLatitudeRef
+ <para />
+ Exif.GPSInfo.GPSLongitude
+ <para />
+ Exif.GPSInfo.GPSLongitudeRef
+ </para>
+ </entry>
+ <entry>
+ <para>Latitude, Longitude</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.localtime</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.GPSInfo.GPSLatitude
+ <para />
+ Exif.GPSInfo.GPSLatitudeRef
+ <para />
+ Exif.GPSInfo.GPSLongitude
+ <para />
+ Exif.GPSInfo.GPSLongitudeRef
+ <para />
+ Exif.GPSInfo.GPSDateStamp
+ <para />
+ Exif.GPSInfo.GPSTimeStamp
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Local time corrected for UTC offset, DST correction
+ <footnote id='ref1'>
+ <para>
+ Refer to
+ <link linkend="GuideReferenceUTC">UTC and DST</link>
+ section.
+ </para>
+ </footnote>
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.timezone</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.GPSInfo.GPSLatitude
+ <para />
+ Exif.GPSInfo.GPSLatitudeRef
+ <para />
+ Exif.GPSInfo.GPSLongitude
+ <para />
+ Exif.GPSInfo.GPSLongitudeRef
+ </para>
+ </entry>
+ <entry>
+ <para>
+ Timezone indicated by lat/long
+ <footnote id='ref1'>
+ <para>
+ Refer to
+ <link linkend="GuideReferenceUTC">UTC and DST</link>
+ section.
+ </para>
+ </footnote>
+ </para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.countryname</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.GPSInfo.GPSLatitude
+ <para />
+ Exif.GPSInfo.GPSLatitudeRef
+ <para />
+ Exif.GPSInfo.GPSLongitude
+ <para />
+ Exif.GPSInfo.GPSLongitudeRef
+ </para>
+ </entry>
+ <entry>
+ <para>ISO 3166 country name indicated by lat/long</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.countrycode</para>
+ </entry>
+ <entry>
+ <para>
+ Exif.GPSInfo.GPSLatitude
+ <para />
+ Exif.GPSInfo.GPSLatitudeRef
+ <para />
+ Exif.GPSInfo.GPSLongitude
+ <para />
+ Exif.GPSInfo.GPSLongitudeRef
+ </para>
+ </entry>
+ <entry>
+ <para>ISO 3166 two-letter abbreviated country name indicated by lat/long</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.star_rating</para>
+ </entry>
+ <entry>
+ <para>Xmp.xmp.Rating</para>
+ </entry>
+ <entry>
+ <para>Rating shown as a set of 🟊 characters</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ <section id="infosidebar">
+ <title>Info sidebar panes</title>
+ <table frame="all">
+ <title>Fixed panes</title>
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>Tag</para>
+ </entry>
+ <entry>
+ <para>Pane title</para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>Xmp.dc.description</para>
+ </entry>
+ <entry>
+ <para>Comment</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.subject</para>
+ </entry>
+ <entry>
+ <para>Keywords</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.title</para>
+ </entry>
+ <entry>
+ <para>Title</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.xmp.Rating</para>
+ </entry>
+ <entry>
+ <para>Rating</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Headline</para>
+ </entry>
+ <entry>
+ <para>Headline</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <table frame="all">
+ <title>Location and GPS pane</title>
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>Tag</para>
+ </entry>
+ <entry>
+ <para>Field</para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>formatted.GPSPosition</para>
+ </entry>
+ <entry>
+ <para>GPS position</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.GPSAltitude</para>
+ </entry>
+ <entry>
+ <para>GPS altitiude</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.timezone</para>
+ </entry>
+ <entry>
+ <para>Time zone</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Country</para>
+ </entry>
+ <entry>
+ <para>Country</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>
+ <para>Xmp.iptc.CountryCode</para>
+ </para>
+ </entry>
+ <entry>
+ <para>Country Code</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.State</para>
+ </entry>
+ <entry>
+ <para>State</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.City</para>
+ </entry>
+ <entry>
+ <para>City</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.iptc.Location</para>
+ </entry>
+ <entry>
+ <para>Location</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <table frame="all">
+ <title>Copyright pane</title>
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>Tag</para>
+ </entry>
+ <entry>
+ <para>Field</para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>Xmp.dc.creator</para>
+ </entry>
+ <entry>
+ <para>Creator</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.contributor</para>
+ </entry>
+ <entry>
+ <para>Contributor</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.rights</para>
+ </entry>
+ <entry>
+ <para>Rights</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <table frame="all">
+ <title>Exif pane</title>
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>Tag</para>
+ </entry>
+ <entry>
+ <para>Field</para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>formatted.Camera</para>
+ </entry>
+ <entry>
+ <para>Camera</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.DateTime</para>
+ </entry>
+ <entry>
+ <para>Date</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.localtime</para>
+ </entry>
+ <entry>
+ <para>Local time</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.ShutterSpeed</para>
+ </entry>
+ <entry>
+ <para>Shutter speed</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.Aperture</para>
+ </entry>
+ <entry>
+ <para>Aperture</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.ExposureBias</para>
+ </entry>
+ <entry>
+ <para>Exposure bias</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.ISOSpeedRating</para>
+ </entry>
+ <entry>
+ <para>ISO sensitivity</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.FocalLength</para>
+ </entry>
+ <entry>
+ <para>Focal length</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.FocalLength35mmFilm</para>
+ </entry>
+ <entry>
+ <para>Focal length 35mm</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.SubjectDistance</para>
+ </entry>
+ <entry>
+ <para>Subject distance</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.Flash</para>
+ </entry>
+ <entry>
+ <para>Flash</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.Resolution</para>
+ </entry>
+ <entry>
+ <para>Resolution</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>formatted.ColorProfile</para>
+ </entry>
+ <entry>
+ <para>Color profile</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Exif.Photo.ExposureProgram</para>
+ </entry>
+ <entry>
+ <para>Exposure Program</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Exif.Photo.MeteringMode</para>
+ </entry>
+ <entry>
+ <para>Metering Mode</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Exif.Photo.LightSource</para>
+ </entry>
+ <entry>
+ <para>Light Source</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+ <section id="exifiptc">
+ <title>Exif IPTC alternative keys</title>
+ <table frame="all">
+ <title>Conversion table</title>
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <thead>
+ <row>
+ <entry>
+ <para>Tag</para>
+ </entry>
+ <entry>
+ <para>Field</para>
+ </entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <para>Xmp.tiff.Orientation</para>
+ </entry>
+ <entry>
+ <para>Exif.Image.Orientation</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.title</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.ObjectName</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Urgency</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Urgency</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Category</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Category</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.SupplementalCategory</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.SuppCategory</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.subject</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Keywords</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.iptc.Location</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.LocationName</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Instruction</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.SpecialInstructions</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.DateCreated</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.DateCreated</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.creator</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Byline</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.AuthorsPosition</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.BylineTitle</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.City</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.City</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.State</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.ProvinceState</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.iptc.CountryCode</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.CountryCode</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Country</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.CountryName</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.TransmissionReference</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.TransmissionReference</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Headline</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Headline</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Credit</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Credit</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.Source</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Source</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.rights</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Copyright</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.dc.description</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Caption</para>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <para>Xmp.photoshop.CaptionWriter</para>
+ </entry>
+ <entry>
+ <para>Iptc.Application2.Writer</para>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceThumbnails">\r
- <title>Thumbnails</title>\r
- <note>\r
- <para>\r
- This page only refers the Geeqie thumbnail caching mechanism, the shared thumbnail cache mechanism is described in\r
- <link linkend="GuideReferenceStandards">Thumbnail Standards</link>\r
- .\r
- </para>\r
- </note>\r
- <para />\r
- <section id="Format">\r
- <title>Format</title>\r
- <para>Thumbnails are stored in PNG image format. The thumbnail name is the name of the source image with “.png” appended.</para>\r
- <para>The modification time (mtime) of the thumbnail is set to match the source file. Thumbnails are regenerated when the timestamps of the thumbnail and source file do not match.</para>\r
- <para />\r
- </section>\r
- <section id="Location">\r
- <title>Location</title>\r
- <para>\r
- Thumbnails are stored in a location specified in\r
- <link linkend="PreferencesThumbnails">Thumbnail Preferences</link>\r
- .\r
-\r
- </para>\r
- <para>The directory structure of the thumbnail cache duplicates that of the location of the source files.</para>\r
- </section>\r
- <section id="Size">\r
- <title>Size</title>\r
- <para>Geeqie allows the following sizes for thumbnails:</para>\r
- <para>24x24, 32x32, 48x48, 64x64, 96x72, 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192, 256x256, custom</para>\r
- <para>Custom size has a maximum of 512x512.</para>\r
- <para>The thumbnail is scaled to fit within the preferred size maintaining the aspect ratio. Thumbnails are not cached for images that are equal to or smaller than the preferred thumbnail size.</para>\r
- <para>When a cached thumbnail's width and height do not match the preferred size, the thumbnail is regenerated.</para>\r
- <para />\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceThumbnails">
+ <title>Thumbnails</title>
+ <note>
+ <para>
+ This page only refers the Geeqie thumbnail caching mechanism, the shared thumbnail cache mechanism is described in
+ <link linkend="GuideReferenceStandards">Thumbnail Standards</link>
+ .
+ </para>
+ </note>
+ <para />
+ <section id="Format">
+ <title>Format</title>
+ <para>Thumbnails are stored in PNG image format. The thumbnail name is the name of the source image with “.png” appended.</para>
+ <para>The modification time (mtime) of the thumbnail is set to match the source file. Thumbnails are regenerated when the timestamps of the thumbnail and source file do not match.</para>
+ <para />
+ </section>
+ <section id="Location">
+ <title>Location</title>
+ <para>
+ Thumbnails are stored in a location specified in
+ <link linkend="PreferencesThumbnails">Thumbnail Preferences</link>
+ .
+
+ </para>
+ <para>The directory structure of the thumbnail cache duplicates that of the location of the source files.</para>
+ </section>
+ <section id="Size">
+ <title>Size</title>
+ <para>Geeqie allows the following sizes for thumbnails:</para>
+ <para>24x24, 32x32, 48x48, 64x64, 96x72, 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192, 256x256, custom</para>
+ <para>Custom size has a maximum of 512x512.</para>
+ <para>The thumbnail is scaled to fit within the preferred size maintaining the aspect ratio. Thumbnails are not cached for images that are equal to or smaller than the preferred thumbnail size.</para>
+ <para>When a cached thumbnail's width and height do not match the preferred size, the thumbnail is regenerated.</para>
+ <para />
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideReferenceUTC">\r
- <title id="titleGuideReferenceUTC">UTC and Daylight Saving Time (DST)</title>\r
- <para>Geeqie can display the local time at which a photo was taken, adjusted for UTC offset and Daylight Saving Time.</para>\r
- <para>\r
- If the image exif data contains the required parameters (see\r
- <link linkend="GuideReferenceXmpExif">Pre-formatted tags</link>\r
- ), Geeqie will use the latitude and longitude to determine which timezone the image was taken in.\r
- <para />\r
- The UTC offset and Daylight Saving Time Correction for that timezone, combined with the GPS UTC value, will then be used to compute the correct local time.\r
- <para />\r
- This value may be displayed in either the Info Sidebar or Overlay Screen Display by using the parameter\r
- <code>formatted.localtime</code>\r
- </para>\r
- <para>\r
- The timezone for the image may also be displayed by using the parameter\r
- <code>formatted.timezone</code>\r
- .\r
- </para>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceUTC">
+ <title id="titleGuideReferenceUTC">UTC and Daylight Saving Time (DST)</title>
+ <para>Geeqie can display the local time at which a photo was taken, adjusted for UTC offset and Daylight Saving Time.</para>
+ <para>
+ If the image exif data contains the required parameters (see
+ <link linkend="GuideReferenceXmpExif">Pre-formatted tags</link>
+ ), Geeqie will use the latitude and longitude to determine which timezone the image was taken in.
+ <para />
+ The UTC offset and Daylight Saving Time Correction for that timezone, combined with the GPS UTC value, will then be used to compute the correct local time.
+ <para />
+ This value may be displayed in either the Info Sidebar or Overlay Screen Display by using the parameter
+ <code>formatted.localtime</code>
+ </para>
+ <para>
+ The timezone for the image may also be displayed by using the parameter
+ <code>formatted.timezone</code>
+ .
+ </para>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<chapter id="GuideSidebars">\r
- <title id="titleGuideSidebars">Sidebars</title>\r
- <para>\r
- A sidebar is a panel that appears next to an\r
- <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />\r
- , and displays additional information about the image.\r
- </para>\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideSidebarsInfo.xml" />\r
- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideSidebarsSortManager.xml" />\r
-</chapter>\r
+<?xml version="1.0" encoding="utf-8"?>
+<chapter id="GuideSidebars">
+ <title id="titleGuideSidebars">Sidebars</title>
+ <para>
+ A sidebar is a panel that appears next to an
+ <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />
+ , and displays additional information about the image.
+ </para>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideSidebarsInfo.xml" />
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideSidebarsSortManager.xml" />
+</chapter>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideSidebarsInfo">\r
- <title>Info Sidebar</title>\r
- <para>The Info Sidebar shows various information about the image and can also be used for metadata editing.</para>\r
- <para>\r
- To toggle display of the Sort Manager select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Ctrl</keycap>\r
- <keycap>K</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>View</guimenu>\r
- <guimenuitem>Info Sidebar</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <para>It consists of several panes. Left-clicking on the pane title expands or collapses the pane. Right-clicking on the pane title or on empty space opens a context menu allowing you to add and remove panes, or move them up and down.</para>\r
- <para />\r
- <section id="Histogram">\r
- <title>Histogram</title>\r
- <para>\r
- This histogram is identical to that shown in the\r
- <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />\r
- . It can be configured by right-click to modify the display of color or linear/logarithmic scale.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="TextpaneTitle">\r
- <title>Title</title>\r
- >\r
- <note>\r
- <para>\r
- Title text is stored in the\r
- <emphasis>Xmp.dc.title</emphasis>\r
- tag.\r
- </para>\r
- </note>\r
- <para />\r
- </section>\r
- <section id="TextpaneComment">\r
- <title>Comment</title>\r
- <note>\r
- <para>\r
- Comment text is stored in the\r
- <emphasis>Xmp.dc.description</emphasis>\r
- tag.\r
- </para>\r
- </note>\r
- <para />\r
- </section>\r
- <section id="Keywords">\r
- <title id="titleKeywords">Keywords</title>\r
- <para>Keywords, together with a flexible search tool, are essential for handling large image collections.</para>\r
- <para>Geeqie has free-form keywords and a hierarchical method of adding new keywords to an image.</para>\r
- <note>\r
- <para>\r
- Keywords are stored in the\r
- <emphasis>Xmp.dc.subject</emphasis>\r
- tag.\r
- </para>\r
- </note>\r
- <note>\r
- <para>\r
- Keywords are not case-sensitive unless selected as so in\r
- <link linkend="MetadataMiscellaneous">Preferences</link>\r
- </para>\r
- </note>\r
- <para>The Keyword pane in the sidebar consists of two sections:</para>\r
- <para>\r
- <itemizedlist spacing="compact">\r
- <listitem>The left hand section which is for free-form keywords</listitem>\r
- <listitem>The right hand section which is a hierarchical structure, allowing sets of keywords to be added.</listitem>\r
- </itemizedlist>\r
- </para>\r
- <para>The contents of the left-hand box is the data written to file.</para>\r
- <para>\r
- The right-hand section has two types of entries :\r
- <itemizedlist spacing="compact">\r
- <listitem>Keywords</listitem>\r
- <listitem>Helpers</listitem>\r
- </itemizedlist>\r
- <para>An example of keyword hierarchy is:</para>\r
- <programlisting xml:space="preserve">\r
- [ ] animal\r
- [ ] mammal\r
- [ ] dog\r
- [ ] cat\r
- [ ] insect\r
- [ ] fly\r
- [ ] dragonfly\r
- daytime\r
- [ ] morning\r
- [ ] afternoon\r
- </programlisting>\r
- </para>\r
- <para>\r
- In this example\r
- <emphasis>daytime</emphasis>\r
- is a Helper, and all the others are keywords. Helpers are not stored in metadata - their purpose is only as an organisational aide.\r
- </para>\r
- <para>\r
- In the above example if\r
- <emphasis>cat</emphasis>\r
- is clicked, both\r
- <emphasis>mammal</emphasis>\r
- and\r
- <emphasis>animal</emphasis>\r
- will also automatically be checked, and all three transferred to the left hand box, ready for writing as metadata.\r
- </para>\r
- <para>If a hierarchy of keywords are checked, and the top-level item then un-checked, all lower level keywords will also be unchecked and will be removed from the left-hand pane.</para>\r
- <warning>\r
- <para>This action cannot be undone.</para>\r
- </warning>\r
- <para>Irrespective of their position in a hierarchy in the right-hand box, all keywords are written as individual entries into metadata. When metadata for an image is read in, Geeqie will attempt to recreate any hierarchies within the data, and display it accordingly in the right-hand box.</para>\r
- <para>\r
- Right-click on the left-hand box allows the selected keywords to be written to the currently selected files - the keywords may be either added to the existing contents, or entirely replace the existing content.\r
- <warning>\r
- <para>Keyword completion is used when selecting keywords. If the selected area includes part of a keyword, the selection will automatically be expanded to cover the whole keyword. If no text is selected, all keywords will be used.</para>\r
- </warning>\r
- </para>\r
- <para>\r
- Right-click on the right-hand box allows a connection to be made between a keyword and a mark. The\r
- <link linkend="GuideImageMarks" endterm="titleGuideImageMarks" />\r
- section shows how marks and keywords inter-operate.\r
- </para>\r
- <para>The ordering of keywords in the right-hand box may be changed by drag-and-drop.</para>\r
- <para>\r
- The meta-data write operation for a file is triggered either\r
- <link linkend="Buttons">manually</link>\r
- or as defined in\r
- <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />\r
- .\r
- </para>\r
- <para>\r
- If the right-click menu item\r
- <guimenu>Revert</guimenu>\r
- is executed at any time after a\r
- <guimenu>Show all</guimenu>\r
- or\r
- <guimenu>Collapse all</guimenu>\r
- , the keyword layout will be restored to the state prior to the\r
- <guimenu>Show all</guimenu>\r
- or\r
- <guimenu>Collapse all</guimenu>\r
- .\r
- <para />\r
- If the right-click menu item\r
- <guimenu>Revert</guimenu>\r
- is executed at any time before a\r
- <guimenu>Show all</guimenu>\r
- or\r
- <guimenu>Collapse all</guimenu>\r
- , the keyword layout will be restored to the state existing at start-up.\r
- </para>\r
- <note>\r
- <para>\r
- The selections in the sub-menu\r
- <guimenu>On any change</guimenu>\r
- will affect the operation of the\r
- <guimenu>Revert</guimenu>\r
- option.\r
- </para>\r
- </note>\r
- <para />\r
- </section>\r
- <section id="KeywordAutocompletion">\r
- <title id="titleKeywordAutocompletion">Keyword Autocompletion</title>\r
- <para>\r
- The text box at the bottom of the keywords pane is used for autocompletion. Any keywords typed into the standard keyword box or the autocompletion box will be remembered as candidates for future autocompletion.\r
- <para />\r
- Frequently used sets of keywords can be entered as comma-delimited lists.\r
- <para />\r
- The list of keywords used for autocompletion can be edited on the\r
- <link linkend="GuideOptionsKeywords">Keywords</link>\r
- tab of the Preferences dialog.\r
- <para />\r
- The menu action "Keyword autocomplete", set to\r
- <code>Alt + K</code>\r
- by default, will shift the keyboard focus to the autocomplete box. Pressing\r
- <code>Alt + K</code>\r
- a second time will shift the keyboard focus back to the previous object.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Listpanes-ExifFileinfoCopyrightLocationandGPS">\r
- <title id="titleExif">List panes</title>\r
- <para>\r
- There are five list panes, whose contents can be configured to display Exif, XMP or IPTC metadata tags. The five panes are:\r
- <itemizedlist>\r
- <listitem>Title</listitem>\r
- <listitem>Exif</listitem>\r
- <listitem>File Info</listitem>\r
- <listitem>Location and GPS</listitem>\r
- <listitem>Copyright</listitem>\r
- </itemizedlist>\r
- </para>\r
- <para>Any metadata tag can be displayed in any pane - the pane titles merely exist as an organisational aide.</para>\r
- <para>It is possible to reorganise the data displayed by drag-and-dropping any item within a pane, or from one pane to another (although in some cases it makes little sense to do so).</para>\r
- <para>\r
- <note>It is not possible to undo these actions, nor is there a way to reset the display to its original settings.</note>\r
- </para>\r
- <para>\r
- It is also possible to drag new items from the\r
- <link linkend="GuideOtherWindowsExif" endterm="titleGuideOtherWindowsExif" />\r
- onto any pane.\r
- </para>\r
- <para>As an aide, in addition to standard metadata tags, Geeqie can call lua scripts and also provides certain pre-formatted tags. These tags are:</para>\r
- <table id="formatted_exif">\r
- <tgroup cols="2" rowsep="1" colsep="1">\r
- <tbody>\r
- <row>\r
- <entry>\r
- <emphasis role="strong">Tag</emphasis>\r
- </entry>\r
- <entry>\r
- <emphasis role="strong">Replaced by Meta data</emphasis>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>formatted.Camera</entry>\r
- <entry>Camera and software name</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.DateTime</entry>\r
- <entry>Image Date</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.ShutterSpeed</entry>\r
- <entry>Shutter speed in seconds (e.g. 1/60s)</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.Aperture</entry>\r
- <entry>Aperture (e.g. f5.6)</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.ExposureBias</entry>\r
- <entry>Exposure bias (e.g. +0.3)</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.ISOSpeedRating</entry>\r
- <entry>ISO sensitivity (e.g. 100)</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.FocalLength</entry>\r
- <entry>Focal length</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.FocalLength35mmFilm</entry>\r
- <entry>Focal length 35mm</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.SubjectDistance</entry>\r
- <entry>Subject distance</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.Flash</entry>\r
- <entry>Flash</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.Resolution</entry>\r
- <entry>Resolution</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.ColorProfile</entry>\r
- <entry>Color profile</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.GPSAltitude</entry>\r
- <entry>Altitude above sea level</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.GPSPosition</entry>\r
- <entry>Latitude, Longitude</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.localtime</entry>\r
- <entry>\r
- Local time corrected for UTC offset, DST correction\r
- <footnote id='ref1'>\r
- <para>\r
- Refer to\r
- <link linkend="GuideReferenceUTC">UTC and DST</link>\r
- section.\r
- </para>\r
- </footnote>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>formatted.timezone</entry>\r
- <entry>\r
- Timezone indicated by GPS lat/long values\r
- <footnote id='ref1'>\r
- <para>\r
- Refer to\r
- <link linkend="GuideReferenceUTC">UTC and DST</link>\r
- section.\r
- </para>\r
- </footnote>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>formatted.countryname</entry>\r
- <entry>ISO 3166 country name indicated by GPS lat/long values</entry>\r
- </row>\r
- <row>\r
- <entry>formatted.countrycode</entry>\r
- <entry>ISO 3166 two-letter abbreviated country name indicated by GPS lat/long values</entry>\r
- </row>\r
- <row>\r
- <entry>file.size</entry>\r
- <entry>file size in bytes</entry>\r
- </row>\r
- <row>\r
- <entry>file.date</entry>\r
- <entry>file date and time in human readable form</entry>\r
- </row>\r
- <row>\r
- <entry>file.mode</entry>\r
- <entry>file mode flags</entry>\r
- </row>\r
- <row>\r
- <entry>file.ctime</entry>\r
- <entry>refer to operating system documentation for the meaning of ctime</entry>\r
- </row>\r
- <row>\r
- <entry>file.owner</entry>\r
- <entry>the file's owner. Refer to operating system documentation for the meaning of file permissions</entry>\r
- </row>\r
- <row>\r
- <entry>file.group</entry>\r
- <entry>the file's group. Refer to operating system documentation for the meaning of file permissions</entry>\r
- </row>\r
- <row>\r
- <entry>file.class</entry>\r
- <entry>the file's class e.g. Image, RAW image etc.</entry>\r
- </row>\r
- <row>\r
- <entry>file.link</entry>\r
- <entry>if the file is a symbolic link, shows the path of the source file</entry>\r
- </row>\r
- <row>\r
- <entry>file.page_no</entry>\r
- <entry>if the file is a multi-page file, e.g. .tiff, the current page number and page total is displayed (e.g. [2/10])</entry>\r
- </row>\r
- <row>\r
- <entry>lua.lensID</entry>\r
- <entry>\r
- lens identification data\r
- <footnote id='lensid'>\r
- Requires lua and exiftool.\r
- <note>This function may be slow.</note>\r
- </footnote>\r
- </entry>\r
- </row>\r
- <row>\r
- <entry>lua.<lua script></entry>\r
- <entry>\r
- Call a lua script\r
- <footnote id='lua_ref1'>The output is expected to be text.</footnote>\r
- </entry>\r
- </row>\r
- </tbody>\r
- </tgroup>\r
- </table>\r
- <para>Right-clicking on an item opens the context menu:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Add entry</guilabel>\r
- </term>\r
- <listitem>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Key</guilabel>\r
- </term>\r
- <listitem>\r
- <para>\r
- Exif, IPTC, XMP or\r
- <link linkend="formatted_exif">Geeqie formatted exif</link>\r
- tags.\r
- </para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Title</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Displayed title text.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Show only if set</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Inhibit display if the tag is empty.</para>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Editable</guilabel>\r
- </term>\r
- <listitem>\r
- <para>Displays the value as editable.</para>\r
- <note>\r
- <para>Geeqie internally converts Exif and IPTC metadata to XMP on read and back on write, thus any changes made to Exif and IPTC here will be lost on write. You must edit the corresponding XMP instead.</para>\r
- <para>An exception is Makernote tags which don't have an equivalent in XMP. However Makernotes cannot be written to an external file (a sidecar or Geeqie metadata file).</para>\r
- </note>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- </listitem>\r
- </varlistentry>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Show hidden</guilabel>\r
- </term>\r
- <listitem>\r
- Shows all entries regardless of\r
- <emphasis>Show only if set</emphasis>\r
- .\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="GPSMap">\r
- <title>Map Display</title>\r
- <para>\r
- Geeqie can display maps created by the\r
- <ulink url="https://www.openstreetmap.org">openstreetmap.org</ulink>\r
- . To use this facility, Geeqie must have been compiled with the --enable-map option.\r
- </para>\r
- <itemizedlist spacing="compact">\r
- <listitem>\r
- <para>\r
- Image location display\r
- <para />\r
- All geocoded images in the currently displayed folder will show as small icons on the map. Clicking the icon will expand the icon to show an image thumbnail, plus other pre-defined image data.\r
- </para>\r
- <para>Right-click on the map will show other map options.</para>\r
- <para>Middle-click controls the map-centering function.</para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- Geo-coded search\r
- <para />\r
- Left-click stores the latitude/longitude under the cursor into the clipboard. This may be used to define the origin of a\r
- <link linkend="Searchparameters">geocode search</link>\r
- .\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- Geo-coding Images\r
- <para />\r
- If an image is not geocoded, the filename or icon on the file pane can be dragged-and-dropped onto the map. The image latitude and longitude xmp meta-data will be updated to the drop position on the map.\r
- </para>\r
- </listitem>\r
- <listitem>\r
- <para>\r
- Map Centering\r
- <para />\r
- If an internet URL containing a valid latitude and longitude is dropped on the map, the map will be re-centered on that location. The zoom level will not change. Refer to\r
- <link linkend="GuideReferenceDecodeLatLong">Decoding Latitude and Longitude</link>\r
- .\r
- </para>\r
- </listitem>\r
- </itemizedlist>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideSidebarsInfo">
+ <title>Info Sidebar</title>
+ <para>The Info Sidebar shows various information about the image and can also be used for metadata editing.</para>
+ <para>
+ To toggle display of the Sort Manager select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>K</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>Info Sidebar</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <para>It consists of several panes. Left-clicking on the pane title expands or collapses the pane. Right-clicking on the pane title or on empty space opens a context menu allowing you to add and remove panes, or move them up and down.</para>
+ <para />
+ <section id="Histogram">
+ <title>Histogram</title>
+ <para>
+ This histogram is identical to that shown in the
+ <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />
+ . It can be configured by right-click to modify the display of color or linear/logarithmic scale.
+ </para>
+ <para />
+ </section>
+ <section id="TextpaneTitle">
+ <title>Title</title>
+ >
+ <note>
+ <para>
+ Title text is stored in the
+ <emphasis>Xmp.dc.title</emphasis>
+ tag.
+ </para>
+ </note>
+ <para />
+ </section>
+ <section id="TextpaneComment">
+ <title>Comment</title>
+ <note>
+ <para>
+ Comment text is stored in the
+ <emphasis>Xmp.dc.description</emphasis>
+ tag.
+ </para>
+ </note>
+ <para />
+ </section>
+ <section id="Keywords">
+ <title id="titleKeywords">Keywords</title>
+ <para>Keywords, together with a flexible search tool, are essential for handling large image collections.</para>
+ <para>Geeqie has free-form keywords and a hierarchical method of adding new keywords to an image.</para>
+ <note>
+ <para>
+ Keywords are stored in the
+ <emphasis>Xmp.dc.subject</emphasis>
+ tag.
+ </para>
+ </note>
+ <note>
+ <para>
+ Keywords are not case-sensitive unless selected as so in
+ <link linkend="MetadataMiscellaneous">Preferences</link>
+ </para>
+ </note>
+ <para>The Keyword pane in the sidebar consists of two sections:</para>
+ <para>
+ <itemizedlist spacing="compact">
+ <listitem>The left hand section which is for free-form keywords</listitem>
+ <listitem>The right hand section which is a hierarchical structure, allowing sets of keywords to be added.</listitem>
+ </itemizedlist>
+ </para>
+ <para>The contents of the left-hand box is the data written to file.</para>
+ <para>
+ The right-hand section has two types of entries :
+ <itemizedlist spacing="compact">
+ <listitem>Keywords</listitem>
+ <listitem>Helpers</listitem>
+ </itemizedlist>
+ <para>An example of keyword hierarchy is:</para>
+ <programlisting xml:space="preserve">
+ [ ] animal
+ [ ] mammal
+ [ ] dog
+ [ ] cat
+ [ ] insect
+ [ ] fly
+ [ ] dragonfly
+ daytime
+ [ ] morning
+ [ ] afternoon
+ </programlisting>
+ </para>
+ <para>
+ In this example
+ <emphasis>daytime</emphasis>
+ is a Helper, and all the others are keywords. Helpers are not stored in metadata - their purpose is only as an organisational aide.
+ </para>
+ <para>
+ In the above example if
+ <emphasis>cat</emphasis>
+ is clicked, both
+ <emphasis>mammal</emphasis>
+ and
+ <emphasis>animal</emphasis>
+ will also automatically be checked, and all three transferred to the left hand box, ready for writing as metadata.
+ </para>
+ <para>If a hierarchy of keywords are checked, and the top-level item then un-checked, all lower level keywords will also be unchecked and will be removed from the left-hand pane.</para>
+ <warning>
+ <para>This action cannot be undone.</para>
+ </warning>
+ <para>Irrespective of their position in a hierarchy in the right-hand box, all keywords are written as individual entries into metadata. When metadata for an image is read in, Geeqie will attempt to recreate any hierarchies within the data, and display it accordingly in the right-hand box.</para>
+ <para>
+ Right-click on the left-hand box allows the selected keywords to be written to the currently selected files - the keywords may be either added to the existing contents, or entirely replace the existing content.
+ <warning>
+ <para>Keyword completion is used when selecting keywords. If the selected area includes part of a keyword, the selection will automatically be expanded to cover the whole keyword. If no text is selected, all keywords will be used.</para>
+ </warning>
+ </para>
+ <para>
+ Right-click on the right-hand box allows a connection to be made between a keyword and a mark. The
+ <link linkend="GuideImageMarks" endterm="titleGuideImageMarks" />
+ section shows how marks and keywords inter-operate.
+ </para>
+ <para>The ordering of keywords in the right-hand box may be changed by drag-and-drop.</para>
+ <para>
+ The meta-data write operation for a file is triggered either
+ <link linkend="Buttons">manually</link>
+ or as defined in
+ <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />
+ .
+ </para>
+ <para>
+ If the right-click menu item
+ <guimenu>Revert</guimenu>
+ is executed at any time after a
+ <guimenu>Show all</guimenu>
+ or
+ <guimenu>Collapse all</guimenu>
+ , the keyword layout will be restored to the state prior to the
+ <guimenu>Show all</guimenu>
+ or
+ <guimenu>Collapse all</guimenu>
+ .
+ <para />
+ If the right-click menu item
+ <guimenu>Revert</guimenu>
+ is executed at any time before a
+ <guimenu>Show all</guimenu>
+ or
+ <guimenu>Collapse all</guimenu>
+ , the keyword layout will be restored to the state existing at start-up.
+ </para>
+ <note>
+ <para>
+ The selections in the sub-menu
+ <guimenu>On any change</guimenu>
+ will affect the operation of the
+ <guimenu>Revert</guimenu>
+ option.
+ </para>
+ </note>
+ <para />
+ </section>
+ <section id="KeywordAutocompletion">
+ <title id="titleKeywordAutocompletion">Keyword Autocompletion</title>
+ <para>
+ The text box at the bottom of the keywords pane is used for autocompletion. Any keywords typed into the standard keyword box or the autocompletion box will be remembered as candidates for future autocompletion.
+ <para />
+ Frequently used sets of keywords can be entered as comma-delimited lists.
+ <para />
+ The list of keywords used for autocompletion can be edited on the
+ <link linkend="GuideOptionsKeywords">Keywords</link>
+ tab of the Preferences dialog.
+ <para />
+ The menu action "Keyword autocomplete", set to
+ <code>Alt + K</code>
+ by default, will shift the keyboard focus to the autocomplete box. Pressing
+ <code>Alt + K</code>
+ a second time will shift the keyboard focus back to the previous object.
+ </para>
+ <para />
+ </section>
+ <section id="Listpanes-ExifFileinfoCopyrightLocationandGPS">
+ <title id="titleExif">List panes</title>
+ <para>
+ There are five list panes, whose contents can be configured to display Exif, XMP or IPTC metadata tags. The five panes are:
+ <itemizedlist>
+ <listitem>Title</listitem>
+ <listitem>Exif</listitem>
+ <listitem>File Info</listitem>
+ <listitem>Location and GPS</listitem>
+ <listitem>Copyright</listitem>
+ </itemizedlist>
+ </para>
+ <para>Any metadata tag can be displayed in any pane - the pane titles merely exist as an organisational aide.</para>
+ <para>It is possible to reorganise the data displayed by drag-and-dropping any item within a pane, or from one pane to another (although in some cases it makes little sense to do so).</para>
+ <para>
+ <note>It is not possible to undo these actions, nor is there a way to reset the display to its original settings.</note>
+ </para>
+ <para>
+ It is also possible to drag new items from the
+ <link linkend="GuideOtherWindowsExif" endterm="titleGuideOtherWindowsExif" />
+ onto any pane.
+ </para>
+ <para>As an aide, in addition to standard metadata tags, Geeqie can call lua scripts and also provides certain pre-formatted tags. These tags are:</para>
+ <table id="formatted_exif">
+ <tgroup cols="2" rowsep="1" colsep="1">
+ <tbody>
+ <row>
+ <entry>
+ <emphasis role="strong">Tag</emphasis>
+ </entry>
+ <entry>
+ <emphasis role="strong">Replaced by Meta data</emphasis>
+ </entry>
+ </row>
+ <row>
+ <entry>formatted.Camera</entry>
+ <entry>Camera and software name</entry>
+ </row>
+ <row>
+ <entry>formatted.DateTime</entry>
+ <entry>Image Date</entry>
+ </row>
+ <row>
+ <entry>formatted.ShutterSpeed</entry>
+ <entry>Shutter speed in seconds (e.g. 1/60s)</entry>
+ </row>
+ <row>
+ <entry>formatted.Aperture</entry>
+ <entry>Aperture (e.g. f5.6)</entry>
+ </row>
+ <row>
+ <entry>formatted.ExposureBias</entry>
+ <entry>Exposure bias (e.g. +0.3)</entry>
+ </row>
+ <row>
+ <entry>formatted.ISOSpeedRating</entry>
+ <entry>ISO sensitivity (e.g. 100)</entry>
+ </row>
+ <row>
+ <entry>formatted.FocalLength</entry>
+ <entry>Focal length</entry>
+ </row>
+ <row>
+ <entry>formatted.FocalLength35mmFilm</entry>
+ <entry>Focal length 35mm</entry>
+ </row>
+ <row>
+ <entry>formatted.SubjectDistance</entry>
+ <entry>Subject distance</entry>
+ </row>
+ <row>
+ <entry>formatted.Flash</entry>
+ <entry>Flash</entry>
+ </row>
+ <row>
+ <entry>formatted.Resolution</entry>
+ <entry>Resolution</entry>
+ </row>
+ <row>
+ <entry>formatted.ColorProfile</entry>
+ <entry>Color profile</entry>
+ </row>
+ <row>
+ <entry>formatted.GPSAltitude</entry>
+ <entry>Altitude above sea level</entry>
+ </row>
+ <row>
+ <entry>formatted.GPSPosition</entry>
+ <entry>Latitude, Longitude</entry>
+ </row>
+ <row>
+ <entry>formatted.localtime</entry>
+ <entry>
+ Local time corrected for UTC offset, DST correction
+ <footnote id='ref1'>
+ <para>
+ Refer to
+ <link linkend="GuideReferenceUTC">UTC and DST</link>
+ section.
+ </para>
+ </footnote>
+ </entry>
+ </row>
+ <row>
+ <entry>formatted.timezone</entry>
+ <entry>
+ Timezone indicated by GPS lat/long values
+ <footnote id='ref1'>
+ <para>
+ Refer to
+ <link linkend="GuideReferenceUTC">UTC and DST</link>
+ section.
+ </para>
+ </footnote>
+ </entry>
+ </row>
+ <row>
+ <entry>formatted.countryname</entry>
+ <entry>ISO 3166 country name indicated by GPS lat/long values</entry>
+ </row>
+ <row>
+ <entry>formatted.countrycode</entry>
+ <entry>ISO 3166 two-letter abbreviated country name indicated by GPS lat/long values</entry>
+ </row>
+ <row>
+ <entry>file.size</entry>
+ <entry>file size in bytes</entry>
+ </row>
+ <row>
+ <entry>file.date</entry>
+ <entry>file date and time in human readable form</entry>
+ </row>
+ <row>
+ <entry>file.mode</entry>
+ <entry>file mode flags</entry>
+ </row>
+ <row>
+ <entry>file.ctime</entry>
+ <entry>refer to operating system documentation for the meaning of ctime</entry>
+ </row>
+ <row>
+ <entry>file.owner</entry>
+ <entry>the file's owner. Refer to operating system documentation for the meaning of file permissions</entry>
+ </row>
+ <row>
+ <entry>file.group</entry>
+ <entry>the file's group. Refer to operating system documentation for the meaning of file permissions</entry>
+ </row>
+ <row>
+ <entry>file.class</entry>
+ <entry>the file's class e.g. Image, RAW image etc.</entry>
+ </row>
+ <row>
+ <entry>file.link</entry>
+ <entry>if the file is a symbolic link, shows the path of the source file</entry>
+ </row>
+ <row>
+ <entry>file.page_no</entry>
+ <entry>if the file is a multi-page file, e.g. .tiff, the current page number and page total is displayed (e.g. [2/10])</entry>
+ </row>
+ <row>
+ <entry>lua.lensID</entry>
+ <entry>
+ lens identification data
+ <footnote id='lensid'>
+ Requires lua and exiftool.
+ <note>This function may be slow.</note>
+ </footnote>
+ </entry>
+ </row>
+ <row>
+ <entry>lua.<lua script></entry>
+ <entry>
+ Call a lua script
+ <footnote id='lua_ref1'>The output is expected to be text.</footnote>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <para>Right-clicking on an item opens the context menu:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Add entry</guilabel>
+ </term>
+ <listitem>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Key</guilabel>
+ </term>
+ <listitem>
+ <para>
+ Exif, IPTC, XMP or
+ <link linkend="formatted_exif">Geeqie formatted exif</link>
+ tags.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Title</guilabel>
+ </term>
+ <listitem>
+ <para>Displayed title text.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Show only if set</guilabel>
+ </term>
+ <listitem>
+ <para>Inhibit display if the tag is empty.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Editable</guilabel>
+ </term>
+ <listitem>
+ <para>Displays the value as editable.</para>
+ <note>
+ <para>Geeqie internally converts Exif and IPTC metadata to XMP on read and back on write, thus any changes made to Exif and IPTC here will be lost on write. You must edit the corresponding XMP instead.</para>
+ <para>An exception is Makernote tags which don't have an equivalent in XMP. However Makernotes cannot be written to an external file (a sidecar or Geeqie metadata file).</para>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <guilabel>Show hidden</guilabel>
+ </term>
+ <listitem>
+ Shows all entries regardless of
+ <emphasis>Show only if set</emphasis>
+ .
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="GPSMap">
+ <title>Map Display</title>
+ <para>
+ Geeqie can display maps created by the
+ <ulink url="https://www.openstreetmap.org">openstreetmap.org</ulink>
+ . To use this facility, Geeqie must have been compiled with the --enable-map option.
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>
+ Image location display
+ <para />
+ All geocoded images in the currently displayed folder will show as small icons on the map. Clicking the icon will expand the icon to show an image thumbnail, plus other pre-defined image data.
+ </para>
+ <para>Right-click on the map will show other map options.</para>
+ <para>Middle-click controls the map-centering function.</para>
+ </listitem>
+ <listitem>
+ <para>
+ Geo-coded search
+ <para />
+ Left-click stores the latitude/longitude under the cursor into the clipboard. This may be used to define the origin of a
+ <link linkend="Searchparameters">geocode search</link>
+ .
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Geo-coding Images
+ <para />
+ If an image is not geocoded, the filename or icon on the file pane can be dragged-and-dropped onto the map. The image latitude and longitude xmp meta-data will be updated to the drop position on the map.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Map Centering
+ <para />
+ If an internet URL containing a valid latitude and longitude is dropped on the map, the map will be re-centered on that location. The zoom level will not change. Refer to
+ <link linkend="GuideReferenceDecodeLatLong">Decoding Latitude and Longitude</link>
+ .
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+</section>
-<?xml version="1.0" encoding="utf-8"?>\r
-<section id="GuideSidebarsSortManager">\r
- <title id="titleGuideSidebarsSortManager">Sort Manager Sidebar</title>\r
- <para>The Sort Manager sidebar provides a convenient method to quickly sort many files into a set of folders or collections.</para>\r
- <para>\r
- To toggle display of the Sort Manager select\r
- <menuchoice>\r
- <shortcut>\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>S</keycap>\r
- </keycombo>\r
- </shortcut>\r
- <guimenu>View</guimenu>\r
- <guimenuitem>Sort Manager</guimenuitem>\r
- </menuchoice>\r
- .\r
- </para>\r
- <para>The mode of the Sort Manager is selected by the drop down list under the sidebar title. The Folder mode allows moving or copying the visible image to a folder, and the Collection mode allows adding the visible image or file selection to a collection.</para>\r
- <para />\r
- <section id="Folderview">\r
- <title>Folder view</title>\r
- <para>The Sort Manager folder view consists of a vertical list for bookmarking folders, a section to select the operation to perform, and a set of buttons along the bottom.</para>\r
- <para>Clicking or activating an item in the list will copy, move, or link the active image's file to that location. The active image will then change to the next image.</para>\r
- <para />\r
- <section id="Bookmarklist">\r
- <title>Bookmark list</title>\r
- <para>This is a list of possible folders to use as a destination for the selected operation. A context menu will appear by right clicking on an item, or pressing the menu key when the item has the focus.</para>\r
- <para>Folders can be added to the list by activating the Add button at the bottom of the sidebar, or dragging a folder onto the list.</para>\r
- <para>\r
- To edit an item select\r
- <emphasis role="bold">Properties</emphasis>\r
- from its context menu. A dialog will appear allowing the Name, Path, and Icon for the item to be changed. Select OK to close the dialog and apply the changes, or Cancel to close the dialog and discard the changes.\r
- </para>\r
- <para>\r
- To change the order of the list, select\r
- <emphasis role="bold">Move up</emphasis>\r
- or\r
- <emphasis role="bold">Move down</emphasis>\r
- from the item's context menu. To move an item with the keyboard move the focus to that item, then press\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>Up</keycap>\r
- </keycombo>\r
- or\r
- <keycombo>\r
- <keycap>Shift</keycap>\r
- <keycap>Down</keycap>\r
- </keycombo>\r
- to move the item.\r
- </para>\r
- <para>\r
- To remove an item from the list select\r
- <emphasis role="bold">Remove</emphasis>\r
- from it's context menu.\r
- </para>\r
- <para />\r
- </section>\r
- <section id="CopyMoveandLink">\r
- <title>Copy, Move, Link and Desktop actions</title>\r
- <para>\r
- Copy, Move and Symbolic Link are available operations to use on the active image; they should be self explanatory. In some cases, Desktop files are also listed. This is detailed in\r
- <link linkend="Geeqieextensions" endterm="titleGuidePluginsConfig" />\r
- </para>\r
- <para />\r
- </section>\r
- <section id="Addbutton">\r
- <title>Add button</title>\r
- <para>Activate this button to add a folder to the bookmark list. A dialog will appear to allow selection of the folder to use for the new item.</para>\r
- <para />\r
- </section>\r
- <section id="Undobutton">\r
- <title>Undo button</title>\r
- <para>Activate this button to undo the last copy, move, or link operation. The undo function can only reverse the most recent operation.</para>\r
- <para />\r
- </section>\r
- </section>\r
- <section id="Collectionview">\r
- <title>Collection view</title>\r
- <para>The Sort Manager collection view consists of a vertical list of collection, a section to determine the current selection, and a set of buttons along the bottom.</para>\r
- <para>Clicking or activating an item in the list will add the selected image to that collection.</para>\r
- <para />\r
- <section id="Collectionlist">\r
- <title>Collection list</title>\r
- <para>\r
- This is the list of collections located in the folder listed in\r
- <link linkend="GuideReferenceConfig">Configuration Files</link>\r
- . Activating a member of this list will result in the current image selection to be added to the collection. If the image already exists within the collection, it will not be added a second time.\r
- </para>\r
- <para>A new empty collection can be added to the list by activating the Add button at the bottom of the sidebar.</para>\r
- <para />\r
- </section>\r
- <section id="Choosingtheselectionstyle">\r
- <title>Choosing the selection style</title>\r
- <para>The images to add when activating a collection is determined by the selection style:</para>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Add image</guilabel>\r
- </term>\r
- <listitem>\r
- <para>The visible image is added to the collection.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <variablelist>\r
- <varlistentry>\r
- <term>\r
- <guilabel>Add selection</guilabel>\r
- </term>\r
- <listitem>\r
- <para>All images selected in the file list will be added to the collection.</para>\r
- </listitem>\r
- </varlistentry>\r
- </variablelist>\r
- <para />\r
- </section>\r
- <section id="Addbutton1">\r
- <title>Add button</title>\r
- <para>Activate this button to add a new empty collection to the visible list. A dialog will appear to allow entry of the name to use for the new collection.</para>\r
- <para />\r
- </section>\r
- <section id="Undobutton1">\r
- <title>Undo button</title>\r
- <para>Activate this button to undo the last add operation. The undo function can only reverse the most recent operation.</para>\r
- <para />\r
- </section>\r
- </section>\r
-</section>\r
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideSidebarsSortManager">
+ <title id="titleGuideSidebarsSortManager">Sort Manager Sidebar</title>
+ <para>The Sort Manager sidebar provides a convenient method to quickly sort many files into a set of folders or collections.</para>
+ <para>
+ To toggle display of the Sort Manager select
+ <menuchoice>
+ <shortcut>
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>S</keycap>
+ </keycombo>
+ </shortcut>
+ <guimenu>View</guimenu>
+ <guimenuitem>Sort Manager</guimenuitem>
+ </menuchoice>
+ .
+ </para>
+ <para>The mode of the Sort Manager is selected by the drop down list under the sidebar title. The Folder mode allows moving or copying the visible image to a folder, and the Collection mode allows adding the visible image or file selection to a collection.</para>
+ <para />
+ <section id="Folderview">
+ <title>Folder view</title>
+ <para>The Sort Manager folder view consists of a vertical list for bookmarking folders, a section to select the operation to perform, and a set of buttons along the bottom.</para>
+ <para>Clicking or activating an item in the list will copy, move, or link the active image's file to that location. The active image will then change to the next image.</para>
+ <para />
+ <section id="Bookmarklist">
+ <title>Bookmark list</title>
+ <para>This is a list of possible folders to use as a destination for the selected operation. A context menu will appear by right clicking on an item, or pressing the menu key when the item has the focus.</para>
+ <para>Folders can be added to the list by activating the Add button at the bottom of the sidebar, or dragging a folder onto the list.</para>
+ <para>
+ To edit an item select
+ <emphasis role="bold">Properties</emphasis>
+ from its context menu. A dialog will appear allowing the Name, Path, and Icon for the item to be changed. Select OK to close the dialog and apply the changes, or Cancel to close the dialog and discard the changes.
+ </para>
+ <para>
+ To change the order of the list, select
+ <emphasis role="bold">Move up</emphasis>
+ or
+ <emphasis role="bold">Move down</emphasis>
+ from the item's context menu. To move an item with the keyboard move the focus to that item, then press
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>Up</keycap>
+ </keycombo>
+ or
+ <keycombo>
+ <keycap>Shift</keycap>
+ <keycap>Down</keycap>
+ </keycombo>
+ to move the item.
+ </para>
+ <para>
+ To remove an item from the list select
+ <emphasis role="bold">Remove</emphasis>
+ from it's context menu.
+ </para>
+ <para />
+ </section>
+ <section id="CopyMoveandLink">
+ <title>Copy, Move, Link and Desktop actions</title>
+ <para>
+ Copy, Move and Symbolic Link are available operations to use on the active image; they should be self explanatory. In some cases, Desktop files are also listed. This is detailed in
+ <link linkend="Geeqieextensions" endterm="titleGuidePluginsConfig" />
+ </para>
+ <para />
+ </section>
+ <section id="Addbutton">
+ <title>Add button</title>
+ <para>Activate this button to add a folder to the bookmark list. A dialog will appear to allow selection of the folder to use for the new item.</para>
+ <para />
+ </section>
+ <section id="Undobutton">
+ <title>Undo button</title>
+ <para>Activate this button to undo the last copy, move, or link operation. The undo function can only reverse the most recent operation.</para>
+ <para />
+ </section>
+ </section>
+ <section id="Collectionview">
+ <title>Collection view</title>
+ <para>The Sort Manager collection view consists of a vertical list of collection, a section to determine the current selection, and a set of buttons along the bottom.</para>
+ <para>Clicking or activating an item in the list will add the selected image to that collection.</para>
+ <para />
+ <section id="Collectionlist">
+ <title>Collection list</title>
+ <para>
+ This is the list of collections located in the folder listed in
+ <link linkend="GuideReferenceConfig">Configuration Files</link>
+ . Activating a member of this list will result in the current image selection to be added to the collection. If the image already exists within the collection, it will not be added a second time.
+ </para>
+ <para>A new empty collection can be added to the list by activating the Add button at the bottom of the sidebar.</para>
+ <para />
+ </section>
+ <section id="Choosingtheselectionstyle">
+ <title>Choosing the selection style</title>
+ <para>The images to add when activating a collection is determined by the selection style:</para>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Add image</guilabel>
+ </term>
+ <listitem>
+ <para>The visible image is added to the collection.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>
+ <guilabel>Add selection</guilabel>
+ </term>
+ <listitem>
+ <para>All images selected in the file list will be added to the collection.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <para />
+ </section>
+ <section id="Addbutton1">
+ <title>Add button</title>
+ <para>Activate this button to add a new empty collection to the visible list. A dialog will appear to allow entry of the name to use for the new collection.</para>
+ <para />
+ </section>
+ <section id="Undobutton1">
+ <title>Undo button</title>
+ <para>Activate this button to undo the last add operation. The undo function can only reverse the most recent operation.</para>
+ <para />
+ </section>
+ </section>
+</section>
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" >\r
-<html>\r
- <head>\r
- <meta name="generator" content="HTML Tidy for HTML5 for Linux version 5.2.0" />\r
- <title>"Geeqie Features List"</title>\r
- </head>\r
- <body>\r
- <div id="features">\r
- <h4>Geeqie Feature List</h4>\r
- <ul>\r
- <li>\r
- <p>Single click image viewing / navigation.</p>\r
- </li>\r
- <li>\r
- <p>Zoom functions.</p>\r
- </li>\r
- <li>\r
- <p>Thumbnails, with optional caching and .xvpics support.</p>\r
- </li>\r
- <li>\r
- <p>Multiple file selection for move, copy, delete, rename, drag and drop.</p>\r
- </li>\r
- <li>\r
- <p>Thumbnail preview of the destination for move, copy and rename functions.</p>\r
- </li>\r
- <li>\r
- <p>On-the-fly renaming for move and copy functions, with formatted and auto-rename features.</p>\r
- </li>\r
- <li>\r
- <p>File grouping (an image having jpeg, RAW and xmp files will appear as a single entity).</p>\r
- </li>\r
- <li>\r
- <p>Selectable exif auto-rotation of images.</p>\r
- </li>\r
- <li>\r
- <p>Single click file copy or move to pre-defined folders - with undo feature.</p>\r
- </li>\r
- <li>\r
- <p>Drag and drop.</p>\r
- </li>\r
- <li>\r
- <p>Collections.</p>\r
- </li>\r
- <li>\r
- <p>support for stereoscopic images</p>\r
- <ul>\r
- <li>input: side-by-side (JPS) and MPO format</li>\r
- <li>output: single image, anaglyph, SBS, mirror, SBS half size (3DTV)</li>\r
- </ul>\r
- </li>\r
- <li>\r
- <p>\r
- Viewing raster and vector images, in the following formats:\r
- 3FR, ANI, APM, ARW, BMP, CR2, CRW, CUR, DNG, ERF, GIF, ICNS, ICO, JPE/JPEG/JPG, JPS, KDC, MEF, MPO, MOS, MRW, NEF, ORF, PEF, PTX, PBM/PGM/PNM/PPM, PNG, QIF/QTIF (QuickTime Image Format), RAF, RAW, RW2, SR2, SRF, SVG/SVGZ, TGA/TARGA, TIF/TIFF, WMF, XBM, XPM. Animated GIFs are supported.\r
- </p>\r
- <ul>\r
- <li>\r
- <p>Preview and thumbnails of video clips can be displayed. Clips can be run via a defined external program.</p>\r
- </li>\r
- </ul>\r
- </li>\r
- <li>\r
- <p>Images can be displayed singly in normal or fullscreen mode; static or slideshow mode; in sets of two or four per page for comparison; or as thumbnails of various sizes. Synchronised zoom when multi images are displayed.</p>\r
- </li>\r
- <li>\r
- <p>Pan(orama) view displays image thumbnails in calendar, grid, folder and other layouts.</p>\r
- </li>\r
- <li>\r
- <p>All available metadata and Exif/IPTC/XMP data can be displayed, as well as colour histograms and assigned tags, keywords and comments.</p>\r
- </li>\r
- <li>\r
- <p>Selectable image overlay display box - can contain any text or meta-data.</p>\r
- </li>\r
- <li>\r
- <p>Panels can be docked or floating.</p>\r
- </li>\r
- <li>\r
- <p>Tags, both predefined and custom, can be assigned to images, and stored either as image metadata (where the file format allows), sidecar files, or in directory metadata files. Keywords and comments can also be assigned.</p>\r
- </li>\r
- <li>\r
- <p>Basic editing in the form of lossless 90/180-degree rotation and flipping is supported; external programs such as GIMP, Inkscape, and custom scripts using ImageMagick can be linked to allow further processing.</p>\r
- </li>\r
- <li>\r
- <p>Advanced searching is available using criteria such as filename, file size, age, image dimensions, similarity to a specified image, or by keywords or comments. If images have GPS coordinates embedded, you may also search for images within a radius of a geographical point.</p>\r
- </li>\r
- <li>\r
- <p>Geeqie supports applying the colour profile embedded in an image along with the system monitor profile (or a user-specified monitor profile).</p>\r
- </li>\r
- <li>\r
- <p>Geeqie sessions can be remotely controlled from external software, so it can be used as an image-viewer component of a bigger application.</p>\r
- </li>\r
- <li>\r
- <p>Geeqie includes a 'find duplicates' tool which can compare images using a variety of criteria (filename, file size, visual similarity, dimensions, image content), either within a single folder or between two folders. Finding duplicates ignoring the rotation of images is also supported.</p>\r
- </li>\r
- <li>\r
- <p>Images may be given a rating value (also known as a "star rating").</p>\r
- </li>\r
- <li>\r
- <p>\r
- Maps from\r
- <a href="http://www.openstreetmap.org">OpenStreetMap</a>\r
- may be displayed in a side panel. If an image has GPS coordinates embedded, its position will be displayed on the map - if Image Direction is encoded, that will be displayed also. If an image does not have embedded GPS coordinates, it may be dragged-and-dropped onto the map to encode its position.\r
- </p>\r
- </li>\r
- </ul>\r
- </div>\r
- </body>\r
-</html>\r
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" >
+<html>
+ <head>
+ <meta name="generator" content="HTML Tidy for HTML5 for Linux version 5.2.0" />
+ <title>"Geeqie Features List"</title>
+ </head>
+ <body>
+ <div id="features">
+ <h4>Geeqie Feature List</h4>
+ <ul>
+ <li>
+ <p>Single click image viewing / navigation.</p>
+ </li>
+ <li>
+ <p>Zoom functions.</p>
+ </li>
+ <li>
+ <p>Thumbnails, with optional caching and .xvpics support.</p>
+ </li>
+ <li>
+ <p>Multiple file selection for move, copy, delete, rename, drag and drop.</p>
+ </li>
+ <li>
+ <p>Thumbnail preview of the destination for move, copy and rename functions.</p>
+ </li>
+ <li>
+ <p>On-the-fly renaming for move and copy functions, with formatted and auto-rename features.</p>
+ </li>
+ <li>
+ <p>File grouping (an image having jpeg, RAW and xmp files will appear as a single entity).</p>
+ </li>
+ <li>
+ <p>Selectable exif auto-rotation of images.</p>
+ </li>
+ <li>
+ <p>Single click file copy or move to pre-defined folders - with undo feature.</p>
+ </li>
+ <li>
+ <p>Drag and drop.</p>
+ </li>
+ <li>
+ <p>Collections.</p>
+ </li>
+ <li>
+ <p>support for stereoscopic images</p>
+ <ul>
+ <li>input: side-by-side (JPS) and MPO format</li>
+ <li>output: single image, anaglyph, SBS, mirror, SBS half size (3DTV)</li>
+ </ul>
+ </li>
+ <li>
+ <p>
+ Viewing raster and vector images, in the following formats:
+ 3FR, ANI, APM, ARW, BMP, CR2, CRW, CUR, DNG, ERF, GIF, ICNS, ICO, JPE/JPEG/JPG, JPS, KDC, MEF, MPO, MOS, MRW, NEF, ORF, PEF, PTX, PBM/PGM/PNM/PPM, PNG, QIF/QTIF (QuickTime Image Format), RAF, RAW, RW2, SR2, SRF, SVG/SVGZ, TGA/TARGA, TIF/TIFF, WMF, XBM, XPM. Animated GIFs are supported.
+ </p>
+ <ul>
+ <li>
+ <p>Preview and thumbnails of video clips can be displayed. Clips can be run via a defined external program.</p>
+ </li>
+ </ul>
+ </li>
+ <li>
+ <p>Images can be displayed singly in normal or fullscreen mode; static or slideshow mode; in sets of two or four per page for comparison; or as thumbnails of various sizes. Synchronised zoom when multi images are displayed.</p>
+ </li>
+ <li>
+ <p>Pan(orama) view displays image thumbnails in calendar, grid, folder and other layouts.</p>
+ </li>
+ <li>
+ <p>All available metadata and Exif/IPTC/XMP data can be displayed, as well as colour histograms and assigned tags, keywords and comments.</p>
+ </li>
+ <li>
+ <p>Selectable image overlay display box - can contain any text or meta-data.</p>
+ </li>
+ <li>
+ <p>Panels can be docked or floating.</p>
+ </li>
+ <li>
+ <p>Tags, both predefined and custom, can be assigned to images, and stored either as image metadata (where the file format allows), sidecar files, or in directory metadata files. Keywords and comments can also be assigned.</p>
+ </li>
+ <li>
+ <p>Basic editing in the form of lossless 90/180-degree rotation and flipping is supported; external programs such as GIMP, Inkscape, and custom scripts using ImageMagick can be linked to allow further processing.</p>
+ </li>
+ <li>
+ <p>Advanced searching is available using criteria such as filename, file size, age, image dimensions, similarity to a specified image, or by keywords or comments. If images have GPS coordinates embedded, you may also search for images within a radius of a geographical point.</p>
+ </li>
+ <li>
+ <p>Geeqie supports applying the colour profile embedded in an image along with the system monitor profile (or a user-specified monitor profile).</p>
+ </li>
+ <li>
+ <p>Geeqie sessions can be remotely controlled from external software, so it can be used as an image-viewer component of a bigger application.</p>
+ </li>
+ <li>
+ <p>Geeqie includes a 'find duplicates' tool which can compare images using a variety of criteria (filename, file size, visual similarity, dimensions, image content), either within a single folder or between two folders. Finding duplicates ignoring the rotation of images is also supported.</p>
+ </li>
+ <li>
+ <p>Images may be given a rating value (also known as a "star rating").</p>
+ </li>
+ <li>
+ <p>
+ Maps from
+ <a href="http://www.openstreetmap.org">OpenStreetMap</a>
+ may be displayed in a side panel. If an image has GPS coordinates embedded, its position will be displayed on the map - if Image Direction is encoded, that will be displayed also. If an image does not have embedded GPS coordinates, it may be dragged-and-dropped onto the map to encode its position.
+ </p>
+ </li>
+ </ul>
+ </div>
+ </body>
+</html>
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" >\r
-<html>\r
- <head>\r
- <meta name="generator" content="HTML Tidy for HTML5 for Linux version 5.2.0" />\r
- <title>Installing Geeqie</title>\r
- </head>\r
- <body>\r
- <div id="downloading">\r
- <h2>Downloading</h2>\r
- <p>Geeqie is available as a package with some distributions.</p>\r
- <p>\r
- The source tar of the latest formal release may be downloaded:\r
- <a href="http://geeqie.org/geeqie-1.3.tar.xz">http://geeqie.org/geeqie-1.3.tar.xz</a>\r
- </p>\r
- <p>However Geeqie is stable, and you may download the latest version (if you have installed git) from here:</p>\r
- <p>\r
- Either:\r
- <code>git clone git://www.geeqie.org/geeqie.git</code>\r
- </p>\r
- <p>\r
- Or:\r
- <code>git clone http://www.geeqie.org/git/geeqie.git</code>\r
- </p>\r
- <h2>Installation</h2>\r
- <p>\r
- List compile options:\r
- <code>./autogen.sh --help</code>\r
- </p>\r
- <p>\r
- Common options:\r
- <code>./autogen.sh --disable-gtk3</code>\r
- ,\r
- </p>\r
- <p>\r
- Compilation:\r
- <code>./autogen.sh [options]; make -j<no. of cpu cores></code>\r
- </p>\r
- <p>\r
- Install:\r
- <code>[sudo] make install</code>\r
- </p>\r
- <p>\r
- Removal:\r
- <code>[sudo] make uninstall</code>\r
- </p>\r
- <h4>Note:</h4>\r
- <p>The zip and gzip files at geeqie.org and GitHub contain only the sources - they cannot, by themselves, be used to install Geeqie.</p>\r
- <p>\r
- It is recommended to always use\r
- <code>git clone git://www.geeqie.org/geeqie.git</code>\r
- to download Geeqie. After installing Geeqie you may delete the folder you have cloned Geeqie into.\r
- </p>\r
- <p>However if you leave the folder intact, whenever new features or patches are available, execute:</p>\r
- <p>\r
- <code>git pull; sudo make uninstall; sudo make maintainer-clean; ./autogen.sh; make -j<no. of cpu cores>; sudo make install</code>\r
- </p>\r
- <p>Only the changed sources are downloaded, which makes this a quick operation.</p>\r
- <p>Your configuration file, history file and desktop files are not affected by this process.</p>\r
- <h2>Notes and changes for the latest release</h2>\r
- <p>\r
- See the NEWS file in the installation folder, or\r
- <a href="https://github.com/BestImageViewer/geeqie/blob/master/NEWS">Geeqie News at GitHub</a>\r
- </p>\r
- <p>\r
- And either the ChangeLog file or\r
- <a href="http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git;a=shortlog">Geeqie ChangeLog</a>\r
- </p>\r
- <h2>Requirements</h2>\r
- <h3>Required libraries:</h3>\r
- <pre>\r
- <code>\r
- GTK+ 3.00\r
- www.gtk.org\r
- enabled by default\r
- disable with configure option: --disable-gtk3\r
- or\r
- GTK+ 2.20\r
- disabled by default when GTK+3 libraries are found.\r
- enable with configure option: --disable-gtk3\r
- optional items map display and GPU acceleration are not available\r
- with GTK2\r
- \r
- Note: GTK+3 is still somehow experimental. It is needed for some\r
- features but we have several complains about the GTK+3 usability.\r
- \r
- So if you need a stable version, you are advised to compile it\r
- with GTK+2. If you want to play with the cool new features, use\r
- GTK+3.\r
- </code>\r
- </pre>\r
- <h3>Optional libraries:</h3>\r
- <pre>\r
- <code>\r
- lcms2 2.0\r
- or\r
- lcms 1.14\r
- www.littlecms.com\r
- for color management support\r
- enabled by default\r
- disable with configure option: --disable-lcms\r
- \r
- exiv2 0.11\r
- www.exiv2.org\r
- for enhanced exif support\r
- enabled by default\r
- disable with configure option: --disable-exiv2\r
- \r
- lirc\r
- www.lirc.org\r
- for remote control support\r
- enabled by default\r
- disable with configure option: --disable-lirc\r
- \r
- libchamplain-gtk 0.12\r
- libchamplain 0.12\r
- libclutter 1.0\r
- wiki.gnome.org/Projects/libchamplain\r
- for map display\r
- enabled by default\r
- disable with configure option: --disable-map\r
- \r
- libclutter 1.0\r
- www.clutter-project.org\r
- for GPU acceleration (a check-box on Preferences/Image must also be ticked)\r
- enabled by default\r
- disable with configure option: --disable-gpu-accel\r
- explicitly disabling will also disable the map feature\r
- \r
- lua 5.1\r
- www.lua.org\r
- support for lua scripting\r
- enabled by default\r
- disable with configure option: --disable-lua\r
-\r
- librsvg2-common\r
- for displaying .svg images\r
-\r
- libwmf0.2-7-gtk\r
- for displaying .wmf images\r
-\r
- (see also "Additional pixbuf loaders" in the References section of the Help file)\r
-\r
- awk\r
- when running Geeqie, to use the geo-decode function\r
- \r
- markdown\r
- when compiling Geeqie, to create this file in html format\r
-\r
- libffmpegthumbnailer 2.1.0\r
- for thumbnailing camera video clips\r
- enabled by default\r
- disable with configure option: --disable-libffmpegthumbnailer\r
- </code>\r
- </pre>\r
- </div>\r
- </body>\r
-</html>\r
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" >
+<html>
+ <head>
+ <meta name="generator" content="HTML Tidy for HTML5 for Linux version 5.2.0" />
+ <title>Installing Geeqie</title>
+ </head>
+ <body>
+ <div id="downloading">
+ <h2>Downloading</h2>
+ <p>Geeqie is available as a package with some distributions.</p>
+ <p>
+ The source tar of the latest formal release may be downloaded:
+ <a href="http://geeqie.org/geeqie-1.3.tar.xz">http://geeqie.org/geeqie-1.3.tar.xz</a>
+ </p>
+ <p>However Geeqie is stable, and you may download the latest version (if you have installed git) from here:</p>
+ <p>
+ Either:
+ <code>git clone git://www.geeqie.org/geeqie.git</code>
+ </p>
+ <p>
+ Or:
+ <code>git clone http://www.geeqie.org/git/geeqie.git</code>
+ </p>
+ <h2>Installation</h2>
+ <p>
+ List compile options:
+ <code>./autogen.sh --help</code>
+ </p>
+ <p>
+ Common options:
+ <code>./autogen.sh --disable-gtk3</code>
+ ,
+ </p>
+ <p>
+ Compilation:
+ <code>./autogen.sh [options]; make -j<no. of cpu cores></code>
+ </p>
+ <p>
+ Install:
+ <code>[sudo] make install</code>
+ </p>
+ <p>
+ Removal:
+ <code>[sudo] make uninstall</code>
+ </p>
+ <h4>Note:</h4>
+ <p>The zip and gzip files at geeqie.org and GitHub contain only the sources - they cannot, by themselves, be used to install Geeqie.</p>
+ <p>
+ It is recommended to always use
+ <code>git clone git://www.geeqie.org/geeqie.git</code>
+ to download Geeqie. After installing Geeqie you may delete the folder you have cloned Geeqie into.
+ </p>
+ <p>However if you leave the folder intact, whenever new features or patches are available, execute:</p>
+ <p>
+ <code>git pull; sudo make uninstall; sudo make maintainer-clean; ./autogen.sh; make -j<no. of cpu cores>; sudo make install</code>
+ </p>
+ <p>Only the changed sources are downloaded, which makes this a quick operation.</p>
+ <p>Your configuration file, history file and desktop files are not affected by this process.</p>
+ <h2>Notes and changes for the latest release</h2>
+ <p>
+ See the NEWS file in the installation folder, or
+ <a href="https://github.com/BestImageViewer/geeqie/blob/master/NEWS">Geeqie News at GitHub</a>
+ </p>
+ <p>
+ And either the ChangeLog file or
+ <a href="http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git;a=shortlog">Geeqie ChangeLog</a>
+ </p>
+ <h2>Requirements</h2>
+ <h3>Required libraries:</h3>
+ <pre>
+ <code>
+ GTK+ 3.00
+ www.gtk.org
+ enabled by default
+ disable with configure option: --disable-gtk3
+ or
+ GTK+ 2.20
+ disabled by default when GTK+3 libraries are found.
+ enable with configure option: --disable-gtk3
+ optional items map display and GPU acceleration are not available
+ with GTK2
+
+ Note: GTK+3 is still somehow experimental. It is needed for some
+ features but we have several complains about the GTK+3 usability.
+
+ So if you need a stable version, you are advised to compile it
+ with GTK+2. If you want to play with the cool new features, use
+ GTK+3.
+ </code>
+ </pre>
+ <h3>Optional libraries:</h3>
+ <pre>
+ <code>
+ lcms2 2.0
+ or
+ lcms 1.14
+ www.littlecms.com
+ for color management support
+ enabled by default
+ disable with configure option: --disable-lcms
+
+ exiv2 0.11
+ www.exiv2.org
+ for enhanced exif support
+ enabled by default
+ disable with configure option: --disable-exiv2
+
+ lirc
+ www.lirc.org
+ for remote control support
+ enabled by default
+ disable with configure option: --disable-lirc
+
+ libchamplain-gtk 0.12
+ libchamplain 0.12
+ libclutter 1.0
+ wiki.gnome.org/Projects/libchamplain
+ for map display
+ enabled by default
+ disable with configure option: --disable-map
+
+ libclutter 1.0
+ www.clutter-project.org
+ for GPU acceleration (a check-box on Preferences/Image must also be ticked)
+ enabled by default
+ disable with configure option: --disable-gpu-accel
+ explicitly disabling will also disable the map feature
+
+ lua 5.1
+ www.lua.org
+ support for lua scripting
+ enabled by default
+ disable with configure option: --disable-lua
+
+ librsvg2-common
+ for displaying .svg images
+
+ libwmf0.2-7-gtk
+ for displaying .wmf images
+
+ (see also "Additional pixbuf loaders" in the References section of the Help file)
+
+ awk
+ when running Geeqie, to use the geo-decode function
+
+ markdown
+ when compiling Geeqie, to create this file in html format
+
+ libffmpegthumbnailer 2.1.0
+ for thumbnailing camera video clips
+ enabled by default
+ disable with configure option: --disable-libffmpegthumbnailer
+ </code>
+ </pre>
+ </div>
+ </body>
+</html>
projects / geeqie.git / commitdiff