<?xml version="1.0" encoding="utf-8"?>
<section id="GuideReferenceStandardPlugins">
  <title id="titleGuideReferenceStandardPlugins">Standard Plugins</title>
  <para>The following plugins are supplied as standard with Geeqie.</para>
  <section id="Symlink">
    <title>Symlink</title>
    <para>Creates a symbolic link on the selected files. If a file has sidecars, they will also be symlinked.</para>
    <para>
      This item is displayed in the
      <emphasis role="strong">File</emphasis>
      menu.
    </para>
  </section>
  <section id="Applytheorientationtoimagecontent">
    <title>Apply the orientation to image content</title>
    <para>This command affects only jpeg, tiff and png files. The image file on disk is rotated to the orientation as specified by its Exif Orientation tag.</para>
    <warning>
      <para>External commands exiftran, exiv2 and mogrify, are used to implement this command.</para>
    </warning>
    <para>
      This item is displayed in the
      <emphasis role="strong">Edit/Orientation</emphasis>
      menu.
    </para>
  </section>
  <section id="Cameraimport">
    <title>Camera import</title>
    <para>Imports images from an attached camera to the current folder. If a file with the same name already exists it will not be overwritten, and the new image will not be downloaded.</para>
    <para>File names on digital cameras are not necessarily unique. In some cases the same file name can exist in more than one sub-folder on the camera. As existing images will not be overwritten, subsequent files of the same name will not be downloaded. In this case a dialog will be shown to warn you of this.</para>
    <para>
      You may use the gphoto2 option
      <code>--filename</code>
      option to ensure that all filenames are unique when downloading. Refer to the
      <ulink url="http://www.gphoto.org/doc/manual/ref-gphoto2-cli.html">gphoto2 documentation.</ulink>
    </para>
    <para>
      This item is displayed in the
      <emphasis role="strong">Plugins</emphasis>
      menu.
    </para>
  </section>
  <section id="Exportjpeg">
    <title>Export jpeg</title>
    <para>
      Extracts an embedded jpeg from a raw image to a file in the
      <code>/tmp</code>
      folder. If you wish to to keep this image, it must be copied or moved.
      <para />
      If
      <code>jpgicc</code>
      is installed, the image will be colour-corrected for the currently selected rendering intent.
    </para>
    <para>
      This item is displayed in the
      <emphasis role="strong">Plugins</emphasis>
      menu.
    </para>
  </section>
  <section id="Imagecrop">
    <title>Image crop</title>
    <para>
      If rectangle coordinates have been set by
      <emphasis role="strong">Edit/Draw Rectangle</emphasis>
      , a cropped image will be stored in the
      <code>/tmp</code>
      folder. If you wish to to keep this image, it must be copied or moved.
    </para>
    <para>
      This item is displayed in the
      <emphasis role="strong">Plugins</emphasis>
      menu.
    </para>
  </section>
  <section id="Randomimage">
    <title>Random image</title>
    <para>Selects and displays a random image from a list of all images in Collections and the currently displayed folder.</para>
    <para>
      This item is displayed in the
      <emphasis role="strong">Plugins</emphasis>
      menu.
    </para>
  </section>
  <section id="Tetheredphotography">
    <title>Tethered photography</title>
    <para>
      If a camera is connected to the computer via USB, photos taken are immediately downloaded to the current folder and displayed on the computer.
      <para />
      If a file already exists with the same name, it is not overwritten but the download will not take place.
      <para />
      Auto-rename can be achieved with the --filename option of gphoto2.
      <para />
      In file
      <code>$HOME/.config/gphoto2/settings</code>
      , set the option:
      <code>gphoto2=filename=&lt;see the gphoto2 manual&gt;</code>
    </para>
    <para>
      This item is displayed in the
      <emphasis role="strong">Plugins</emphasis>
      menu.
    </para>
  </section>
</section>
