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