view doc/docbook/GuideImagePresentationFullscreen.xml @ 1743:d8e9d0cc640e

Allow to switch to fullscreen mode using LIRC. Imagine the following situation (which happened to me several times) : you want to see photos from your bed or your sofa so you launch geeqie and go to the right directory, then you take your remote control and sit comfortably far from your keyboard and mouse. And when you want to begin to watch photos, you realize you forgot to enable full screen! You have to stand up and to go until your computer and come back, whereas you could have done it with your remote control. Patch by Bernard Massot.

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