Camera import - warn of duplicate filenames
[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>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>\r
62     <para>\r
63       You may use the gphoto2 option\r
64       <code>--filename</code>\r
65       option to ensure that all filenames are unique when downloading. Refer to the\r
66       <ulink url="http://www.gphoto.org/doc/manual/ref-gphoto2-cli.html">gphoto2 documentation.</ulink>\r
67     </para>\r
68     <para>\r
69       This item is displayed in the\r
70       <emphasis role="strong">Plugins</emphasis>\r
71       menu.\r
72     </para>\r
73   </section>\r
74   <section id="Exportjpeg">\r
75     <title>Export jpeg</title>\r
76     <para>\r
77       Extracts an embedded jpeg from a raw image to a file in the\r
78       <code>/tmp</code>\r
79       folder. If you wish to to keep this image, it must be copied or moved.\r
80       <para />\r
81       If\r
82       <code>jpgicc</code>\r
83       is installed, the image will be colour-corrected for the currently selected rendering intent.\r
84     </para>\r
85     <para>\r
86       This item is displayed in the\r
87       <emphasis role="strong">Plugins</emphasis>\r
88       menu.\r
89     </para>\r
90   </section>\r
91   <section id="Imagecrop">\r
92     <title>Image crop</title>\r
93     <para>\r
94       If rectangle coordinates have been set by\r
95       <emphasis role="strong">Edit/Draw Rectangle</emphasis>\r
96       , a cropped image will be stored in the\r
97       <code>/tmp</code>\r
98       folder. If you wish to to keep this image, it must be copied or moved.\r
99     </para>\r
100     <para>\r
101       This item is displayed in the\r
102       <emphasis role="strong">Plugins</emphasis>\r
103       menu.\r
104     </para>\r
105   </section>\r
106   <section id="Randomimage">\r
107     <title>Random image</title>\r
108     <para>Selects and displays a random image from a list of all images in Collections and the currently displayed folder.</para>\r
109     <para>\r
110       This item is displayed in the\r
111       <emphasis role="strong">Plugins</emphasis>\r
112       menu.\r
113     </para>\r
114   </section>\r
115   <section id="Tetheredphotography">\r
116     <title>Tethered photography</title>\r
117     <para>\r
118       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
119       <para />\r
120       If a file already exists with the same name, it is not overwritten but the download will not take place.\r
121       <para />\r
122       Auto-rename can be achieved with the --filename option of gphoto2.\r
123       <para />\r
124       In file\r
125       <code>$HOME/.config/gphoto2/settings</code>\r
126       , set the option:\r
127       <code>gphoto2=filename=&lt;see the gphoto2 manual&gt;</code>\r
128     </para>\r
129     <para>\r
130       This item is displayed in the\r
131       <emphasis role="strong">Plugins</emphasis>\r
132       menu.\r
133     </para>\r
134   </section>\r
135 </section>\r