-<?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>
- <para/><section id="State"><title>
- State
- </title>
- <variablelist><varlistentry><term>
- Remember window positions
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <para>
- This will maintain windows size and position between Geeqie sessions.
- </para>
- <variablelist><varlistentry><term>
- Remember tool state
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <para>
- This will maintain the tool window state between Geeqie sessions.
- </para>
- <para/></section><section id="Size"><title>
- Size
- </title>
- <variablelist><varlistentry><term>
- Fit window to image when tools are hidden/floating
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <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>
- <variablelist><varlistentry><term>
- Limit size when auto-sizing window
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <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>
- <para/></section><section id="FullScreen"><title>
- Full Screen
- </title>
- <variablelist><varlistentry><term>
- Location
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <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>
- <variablelist><varlistentry><term>
- Stay above other windows
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <para>
- Enable this to have Geeqie ask the window manager to keep the full screen window above other windows. Note that the window manager may ignore the request. This option is not relevant when the full screen location is determined by the window manager.
- </para>
- <variablelist><varlistentry><term>
- Smooth image flip
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <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>
- <variablelist><varlistentry><term>
- Disable screen saver
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <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>
- <para/></section><section id="OverlayScreenDisplay"><title>
- Overlay Screen Display
- </title>
- <variablelist><varlistentry><term>
- Always show image overlay at startup
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <para>
- Enable this to have the image overlay info displayed by default
- </para>
- <variablelist><varlistentry><term>
- Image overlay template
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <para>
- Overlay info is customizable through this template
- </para>
- <para>
- Overlay info format string syntax is: <literal>%tag[:max_length][:extra]%</literal>
- </para>
- <informaltable><tgroup cols="2"><tbody><row><entry>
- Tag
- </entry><entry>
- Replaced by
- </entry></row>
-<row><entry>
- name
- </entry><entry>
- 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 metadata
- </entry></row>
-</tbody></tgroup></informaltable>
- <para>
- To access exif data use the exif name, for example: <literal>%Exif.Photo.DateTimeOriginal%</literal> to get the date of the original shot
- </para>
- <para>
- Pre-formatted exif data is also available:
- </para>
- <informaltable><tgroup cols="2"><tbody><row><entry>
- Tag
- </entry><entry>
- Replaced by exif data
- </entry></row>
-<row><entry>
- formatted.Camera
- </entry><entry>
- Camera and sofware name
- </entry></row>
-<row><entry>
- formatted.<ulink url="/wiki/DateTime">DateTime?</ulink>
- </entry><entry>
- Image Date
- </entry></row>
-<row><entry>
- formatted.<ulink url="/wiki/ShutterSpeed">ShutterSpeed?</ulink>
- </entry><entry>
- Shutter speed in seconds (ie. 1/60s)
- </entry></row>
-<row><entry>
- formatted.Aperture
- </entry><entry>
- Aperture (ie. f5.6)
- </entry></row>
-<row><entry>
- formatted.<ulink url="/wiki/ExposureBias">ExposureBias?</ulink>
- </entry><entry>
- Exposure bias (ie. +0.3)
- </entry></row>
-<row><entry>
- formatted.ISOSpeedRating
- </entry><entry>
- ISO sensitivity (ie. 100)
- </entry></row>
-<row><entry>
- formatted.<ulink url="/wiki/FocalLength">FocalLength?</ulink>
- </entry><entry>
- Focal length
- </entry></row>
-<row><entry>
- formatted.<ulink url="/wiki/FocalLength">FocalLength?</ulink>35mmFilm
- </entry><entry>
- Focal length 35mm
- </entry></row>
-<row><entry>
- formatted.<ulink url="/wiki/SubjectDistance">SubjectDistance?</ulink>
- </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.<ulink url="/wiki/ColorProfile">ColorProfile?</ulink>
- </entry><entry>
- Color profile
- </entry></row>
-</tbody></tgroup></informaltable>
- <para>
- You can limit the length of displayed data using :number notation: <literal>%formatted.Camera:20%</literal> will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation.
- </para>
- <para>
- If two or more variables are connected with the -sign, it prints available variables with a separator:<?db2html element="br"?>
- <literal>%formatted.ShutterSpeed% %formatted.ISOSpeedRating% %formatted.FocalLength%</literal><?db2html element="br"?>
- could show:<?db2html element="br"?>
- "1/20s - 400 - 80 mm"<?db2html element="br"?>
- or<?db2html element="br"?>
- "1/200 - 80 mm" if there's no ISO information in the Exif data.<?db2html element="br"?>
- </para>
- <para>
- If a line is empty, it is removed. This allows to add lines that totally disappear when no data is available.
- </para>
- <para>
- Extra string uses special character '*' to mark the position of the data. If no '*' is present, then extra string is just appended to data. Any "\n" is replaced by a newline on display. Pango mark up is accepted in left and right parts. If data is empty, nothing will be displayed.
- </para>
- <para>
- Examples:
- </para>
- <variablelist><varlistentry><term>
- <literal>%name:&lt;i&gt;*&lt;/i&gt;\n%</literal>
- </term><listitem><para>
- name is displayed in italics ended with a newline
- </para></listitem></varlistentry><varlistentry><term>
- <literal>%size:\n%</literal>
- </term><listitem><para>
- size is displayed with a newline at end
- </para></listitem></varlistentry><varlistentry><term>
- <literal>%formatted.ISOSpeedRating:ISO *%</literal>
- </term><listitem><para>
- ie. "ISO 100"
- </para></listitem></varlistentry><varlistentry><term>
- <literal>Collection &lt;b&gt;*&lt;/b&gt;\n</literal>
- </term><listitem><para>
- display collection name in bold prefixed by "Collection " and a newline is appended
- </para></listitem></varlistentry></variablelist>
- <variablelist><varlistentry><term>
- Help button
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <para>
- Show syntax help
- </para>
- <variablelist><varlistentry><term>
- Defaults button
- </term><listitem><para/></listitem></varlistentry></variablelist>
- <para>
- Restore default image overlay template
- </para>
- <para/></section></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 window positions</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 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
+ </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 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>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><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
projects / geeqie.git / blobdiff