view doc/docbook/GuideImagePresentationFullscreen.xml @ 1779:f64e346a3d9c

Move "Add Keyword" menu item at top of Keywords bar contextual menu. Suggested by Lars T¸«£uber.

<?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>