diff doc/docbook/GuideImagePresentationFullscreen.xml @ 1773:2ae81598b254

scripts for converting wiki documentation to docbook

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/docbook/GuideImagePresentationFullscreen.xml	Sun Nov 22 09:12:22 2009 +0000
@@ -0,0 +1,204 @@
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideImagePresentationFullscreen">
+    <title>
+      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><para>From the menu bar - open the <emphasis role="strong">View</emphasis> menu and select <emphasis role="strong">Full screen</emphasis>.
+      </para></listitem><listitem><para>From the keyboard - press the F key to toggle full screen.
+      </para></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 the F or Esc key 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, open the <emphasis role="strong">View</emphasis> menu and select <emphasis role="strong">Full screen</emphasis>.
+      </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="GuideOptionsAdvanced">Advanced tab?</link> of the preferences dialog.
+    </para>
+    <variablelist><varlistentry><term>
+        Size and location
+      </term><listitem><para/></listitem></varlistentry></variablelist>
+    <para>
+      This can be changed using Full screen size option, this can be used to select the monitor to use in a multiple monitor configuration.
+    </para>
+    <variablelist><varlistentry><term>
+        Smooth image flip in full screen
+      </term><listitem><para/></listitem></varlistentry></variablelist>
+    <para>
+      This option delays the image change until the next image is entirely decoded into memory, the result is a smoother transition between images.
+    </para>
+    <variablelist><varlistentry><term>
+        Disable screen saver in full screen
+      </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.
+    </para>
+    <para/></section><section id="Navigation"><title>
+      Navigation
+    </title>
+    <para>
+      The usual image navigation controls are available when in full screen, these are the commands available:
+    </para>
+    <informaltable><tgroup cols="3"><tbody><row><entry>
+          Keyboard
+        </entry><entry>
+          Mouse
+        </entry><entry>
+          Description
+        </entry></row>
+<row><entry>
+          F, V, Esc
+        </entry><entry>
+          Context menu
+        </entry><entry>
+          Turn off full screen.
+        </entry></row>
+<row><entry>
+          <emphasis role="strong">Image Navigation</emphasis>
+        </entry></row>
+<row><entry>
+          <ulink url="/wiki/PageDown">PageDown?</ulink>
+        </entry><entry>
+          Left Click on image view<?db2html element="br"?>
+          Mouse Wheel down [<ulink url="/wiki#bottomnote1">(*)</ulink>]
+        </entry><entry>
+          Change to next image.
+        </entry></row>
+<row><entry>
+          <ulink url="/wiki/PageUp">PageUp?</ulink>
+        </entry><entry>
+          Middle Click on image view<?db2html element="br"?>
+          Mouse Wheel up [<ulink url="/wiki#bottomnote1">(*)</ulink>]
+        </entry><entry>
+          Change to previous image.
+        </entry></row>
+<row><entry>
+          Home
+        </entry><entry/><entry>
+          Change to first image.
+        </entry></row>
+<row><entry>
+          End
+        </entry><entry/><entry>
+          Change to last image.
+        </entry></row>
+<row><entry>
+          <emphasis role="strong">Image panning</emphasis> (image has keyboard focus)
+        </entry></row>
+<row><entry>
+          Arrows
+        </entry><entry>
+          Left Drag on image view<?db2html element="br"?>
+          Shift + Mouse Wheel [<ulink url="/wiki#bottomnote1">(*)</ulink>]
+        </entry><entry>
+          Pan image.
+        </entry></row>
+<row><entry>
+          Shift + Arrows
+        </entry><entry/><entry>
+          Pan Image faster.
+        </entry></row>
+<row><entry>
+          Ctrl + Arrows
+        </entry><entry/><entry>
+          Pan to respective edge of image.
+        </entry></row>
+<row><entry>
+          <ulink url="/wiki/SpaceBar">SpaceBar?</ulink>
+        </entry><entry/><entry>
+          Change to next image.
+        </entry></row>
+<row><entry>
+          Backspace
+        </entry><entry/><entry>
+          Change to previous image.
+        </entry></row>
+</tbody></tgroup></informaltable>
+    <para>
+      Several other standard controls are also available through the keyboard and context menu:
+    </para>
+    <informaltable><tgroup cols="2"><tbody><row><entry>
+          Function
+        </entry><entry>
+          Difference from normal view
+        </entry></row>
+<row><entry>
+          Copy, Move, Rename
+        </entry><entry>
+          same
+        </entry></row>
+<row><entry>
+          Delete
+        </entry><entry>
+          same
+        </entry></row>
+<row><entry>
+          External edit commands<?db2html element="br"?>
+          (Ctrl + 1 ... 0, context menu)
+        </entry><entry>
+          Full screen will turn off prior to activating the function.
+        </entry></row>
+<row><entry>
+          Open image properties window<?db2html element="br"?>
+          (Ctrl + P, context menu)
+        </entry><entry>
+          same
+        </entry></row>
+<row><entry>
+          Image rotation, mirror, and flip
+        </entry><entry>
+          same
+        </entry></row>
+<row><entry>
+          Zoom controls
+        </entry><entry>
+          same
+        </entry></row>
+<row><entry>
+          I
+        </entry><entry>
+          Toggle information overlay for full screen: on with histogram, on without histogram, off.
+        </entry></row>
+<row><entry>
+          K
+        </entry><entry>
+          Switch between the different histogram modes: RGB, value, maximum value, red channel, green channel, blue channel.
+        </entry></row>
+<row><entry>
+          J
+        </entry><entry>
+          Toogle between linear and logarithmical histogram.
+        </entry></row>
+<row><entry>
+          Slide show controls<?db2html element="br"?>
+          (S, P, context menu)
+        </entry><entry>
+          same
+        </entry></row>
+<row><entry>
+          Quit with Ctrl + Q
+        </entry><entry>
+          same
+        </entry></row>
+</tbody></tgroup></informaltable>
+    <para>
+      (*) Note: Default Mouse wheel functions can be altered by changing the <link linkend="GuideOptionsAdvanced">Mouse wheel scrolls image?</link> option.
+    </para>
+  <para/></section></section>