doc/docbook/GuideReferenceStandardPlugins.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <section id="GuideReferenceStandardPlugins">
   3   <title id="titleGuideReferenceStandardPlugins">Standard Plugins</title>
   4   <para>The following plugins are supplied as standard with Geeqie.</para>
   5   <section id="Applytheorientationtoimagecontent">
   6     <title>Apply the orientation to image content</title>
   7     <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>
   8     <warning>
   9       <para>External commands exiftran, exiv2 and mogrify, are used to implement this command.</para>
  10     </warning>
  11     <para>
  12       This item is displayed in the
  13       <emphasis role="strong">Edit/Orientation</emphasis>
  14       menu.
  15     </para>
  16   </section>
  17   <section id="Cameraimport">
  18     <title>Camera import</title>
  19     <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>
  20     <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>
  21     <para>
  22       You may use the gphoto2 option
  23       <code>--filename</code>
  24       option to ensure that all filenames are unique when downloading. Refer to the
  25       <ulink url="http://www.gphoto.org/doc/manual/ref-gphoto2-cli.html">gphoto2 documentation.</ulink>
  26     </para>
  27     <para>
  28       This item is displayed in the
  29       <emphasis role="strong">Plugins</emphasis>
  30       menu.
  31     </para>
  32   </section>
  33   <section id="Exportjpeg">
  34     <title>Export jpeg</title>
  35     <para>
  36       Extracts an embedded jpeg from a raw image to a file in the
  37       <code>/tmp</code>
  38       folder. If you wish to to keep this image, it must be copied or moved.
  39       <para />
  40       If
  41       <code>jpgicc</code>
  42       is installed, the image will be colour-corrected for the currently selected rendering intent.
  43     </para>
  44     <para>
  45       This item is displayed in the
  46       <emphasis role="strong">Plugins</emphasis>
  47       menu.
  48     </para>
  49   </section>
  50   <section id="Imagecrop">
  51     <title>Image crop</title>
  52     <para>
  53       If rectangle coordinates have been set by
  54       <emphasis role="strong">Edit/Draw Rectangle</emphasis>
  55       , a cropped image will be stored in the
  56       <code>/tmp</code>
  57       folder. If you wish to to keep this image, it must be copied or moved.
  58     </para>
  59     <para>
  60       This item is displayed in the
  61       <emphasis role="strong">Plugins</emphasis>
  62       menu.
  63     </para>
  64   </section>
  65   <section id="OpenWith">
  66     <title>Open With</title>
  67     <para>Call the standard GTK application chooser for a single file.</para>
  68     <para>
  69       This item is also displayed in the
  70       <emphasis role="strong">File</emphasis>
  71       menu.
  72     </para>
  73   </section>
  74   <section id="Randomimage">
  75     <title>Random image</title>
  76     <para>Selects and displays a random image from a list of all images in Collections and the currently displayed folder.</para>
  77     <para>
  78       This item is displayed in the
  79       <emphasis role="strong">Plugins</emphasis>
  80       menu.
  81     </para>
  82   </section>
  83   <section id="downsize">
  84     <title>Resize image</title>
  85     <para>Reduce the size of an image.</para>
  86     <table frame="all">
  87       <tgroup cols="2" rowsep="1" colsep="1">
  88         <thead>
  89           <row>
  90             <entry>Option</entry>
  91             <entry>Meaning</entry>
  92           </row>
  93         </thead>
  94         <tbody>
  95           <row>
  96             <entry>Required size kB</entry>
  97             <entry>desired output file size in kilobytes</entry>
  98           </row>
  99           <row>
 100             <entry>Tolerance %</entry>
 101             <entry>tolerance or allowed size of result greater than desired size expressed as percent of desired</entry>
 102           </row>
 103           <row>
 104             <entry>Max. iterations</entry>
 105             <entry>maximum number of iterations to stop</entry>
 106           </row>
 107           <row>
 108             <entry>Copy if unchanged</entry>
 109             <entry>
 110               copy to output when not downsizing and no image
 111               format change
 112             </entry>
 113           </row>
 114           <row>
 115             <entry>Strip metadata</entry>
 116             <entry>strip all meta data</entry>
 117           </row>
 118           <row>
 119             <entry>Show computation</entry>
 120             <entry>show the values of each iteration</entry>
 121           </row>
 122           <row>
 123             <entry>Open output file in Geeqie</entry>
 124             <entry>on successful conversion set Geeqie focus to the file</entry>
 125           </row>
 126         </tbody>
 127       </tgroup>
 128     </table>
 129     <para>
 130       This plugin uses the Downsize script. The original may be found
 131       <ulink url="http://www.fmwconcepts.com/imagemagick/downsize/index.php">here.</ulink>
 132       It is subject to the following copyright:
 133     </para>
 134     <programlisting>
 135       Copyright © Fred Weinhaus
 136
 137       My scripts are available free of charge for non-commercial (non-profit) use, ONLY.
 138
 139       For use of my scripts in commercial (for-profit) environments or non-free applications,
 140       please contact me (Fred Weinhaus) for licensing arrangements. My email address is fmw at
 141       alink dot net.
 142
 143       If you:
 144       1) redistribute,
 145       2) incorporate any of these scripts into other free applications or
 146       3) reprogram them in another scripting language, then you must contact me for permission,
 147       especially if the result might be used in a commercial or for-profit environment.
 148
 149       Usage, whether stated or not in the script, is restricted to the above licensing
 150       arrangements. It is also subject, in a subordinate manner, to the ImageMagick license, which
 151       can be found at: http://www.imagemagick.org/script/license.php
 152     </programlisting>
 153     <para />
 154   </section>
 155   <section id="Symlink">
 156     <title>Symlink</title>
 157     <para>Creates a symbolic link on the selected files. If a file has sidecars, they will also be symlinked.</para>
 158     <para>
 159       This item is displayed in the
 160       <emphasis role="strong">File</emphasis>
 161       menu.
 162     </para>
 163   </section>
 164   <section id="Tetheredphotography">
 165     <title>Tethered photography</title>
 166     <para>
 167       If a camera is connected to the computer via USB, photos taken are immediately downloaded to the current folder and displayed on the computer.
 168       <para />
 169       If a file already exists with the same name, it is not overwritten but the download will not take place.
 170       <para />
 171       Auto-rename can be achieved with the --filename option of gphoto2.
 172       <para />
 173       In file
 174       <code>$HOME/.config/gphoto2/settings</code>
 175       , set the option:
 176       <code>gphoto2=filename=&lt;see the gphoto2 manual&gt;</code>
 177     </para>
 178     <para>
 179       This item is displayed in the
 180       <emphasis role="strong">Plugins</emphasis>
 181       menu.
 182     </para>
 183   </section>
 184 </section>