Update documentation, remove obsolete GQview import options
[geeqie.git] / doc / docbook / GuideReferenceStandardPlugins.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <section id="GuideReferenceStandardPlugins">\r
3   <title id="titleGuideReferenceStandardPlugins">Standard Plugins</title>\r
4   <para>The following plugins are supplied as standard with Geeqie.</para>\r
5   <section id="EditUFRawIDfile">\r
6     <title>Edit UFRaw ID file</title>\r
7     <para>Creates a UFRaw ID file for each of the selected files.</para>\r
8     <para>\r
9       This item is displayed in the\r
10       <emphasis role="strong">Edit</emphasis>\r
11       menu.\r
12     </para>\r
13   </section>\r
14   <section id="UFRawBatch">\r
15     <title>UFRaw Batch</title>\r
16     <para>\r
17       Searches for new RAW files or for modified UFRaw \r
18       ID files and processes them with\r
19       <code>ufraw-batch</code>\r
20       .\r
21     </para>\r
22     <para>\r
23       This item is displayed in the\r
24       <emphasis role="strong">Edit</emphasis>\r
25       menu.\r
26     </para>\r
27   </section>\r
28   <section id="UFRawBatchrecursive">\r
29     <title>UFRaw Batch recursive</title>\r
30     <para>As above, with a recursive search.</para>\r
31     <para>\r
32       This item is displayed in the\r
33       <emphasis role="strong">Edit</emphasis>\r
34       menu.\r
35     </para>\r
36   </section>\r
37   <section id="Symlink">\r
38     <title>Symlink</title>\r
39     <para>Creates a symbolic link on the selected files. If a file has sidecars, they will also be symlinked.</para>\r
40     <para>\r
41       This item is displayed in the\r
42       <emphasis role="strong">File</emphasis>\r
43       menu.\r
44     </para>\r
45   </section>\r
46   <section id="Applytheorientationtoimagecontent">\r
47     <title>Apply the orientation to image content</title>\r
48     <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>\r
49     <warning>\r
50       <para>External commands exiftran, exiv2 and mogrify, are used to implement this command.</para>\r
51     </warning>\r
52     <para>\r
53       This item is displayed in the\r
54       <emphasis role="strong">Edit/Orientation</emphasis>\r
55       menu.\r
56     </para>\r
57   </section>\r
58   <section id="Cameraimport">\r
59     <title>Camera import</title>\r
60     <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>\r
61     <para>\r
62       This item is displayed in the\r
63       <emphasis role="strong">Plugins</emphasis>\r
64       menu.\r
65     </para>\r
66   </section>\r
67   <section id="Exportjpeg">\r
68     <title>Export jpeg</title>\r
69     <para>\r
70       Extracts an embedded jpeg from a raw image to a file in the\r
71       <code>/tmp</code>\r
72       folder. If you wish to to keep this image, it must be copied or moved.\r
73       <para />\r
74       If\r
75       <code>jpgicc</code>\r
76       is installed, the image will be colour-corrected for the currently selected rendering intent.\r
77     </para>\r
78     <para>\r
79       This item is displayed in the\r
80       <emphasis role="strong">Plugins</emphasis>\r
81       menu.\r
82     </para>\r
83   </section>\r
84   <section id="Imagecrop">\r
85     <title>Image crop</title>\r
86     <para>\r
87       If rectangle coordinates have been set by\r
88       <emphasis role="strong">Edit/Draw Rectangle</emphasis>\r
89       , a cropped image will be stored in the\r
90       <code>/tmp</code>\r
91       folder. If you wish to to keep this image, it must be copied or moved.\r
92     </para>\r
93     <para>\r
94       This item is displayed in the\r
95       <emphasis role="strong">Plugins</emphasis>\r
96       menu.\r
97     </para>\r
98   </section>\r
99   <section id="Randomimage">\r
100     <title>Random image</title>\r
101     <para>Selects and displays a random image from a list of all images in Collections and the currently displayed folder.</para>\r
102     <para>\r
103       This item is displayed in the\r
104       <emphasis role="strong">Plugins</emphasis>\r
105       menu.\r
106     </para>\r
107   </section>\r
108   <section id="Tetheredphotography">\r
109     <title>Tethered photography</title>\r
110     <para>\r
111       If a camera is connected to the computer via USB, photos taken are immediately downloaded to the current folder and displayed on the computer.\r
112       <para />\r
113       If a file already exists with the same name, it is not overwritten but the download will not take place.\r
114       <para />\r
115       Auto-rename can be achieved with the --filename option of gphoto2.\r
116       <para />\r
117       In file\r
118       <code>$HOME/.config/gphoto2/settings</code>\r
119       , set the option:\r
120       <code>gphoto2=filename=&lt;see the gphoto2 manual&gt;</code>\r
121     </para>\r
122     <para>\r
123       This item is displayed in the\r
124       <emphasis role="strong">Plugins</emphasis>\r
125       menu.\r
126     </para>\r
127   </section>\r
128 </section>\r