Minor documentation updates
[geeqie.git] / doc / docbook / GuideFaq.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <chapter id="GuideFaq">\r
3   <title>Frequently Asked Questions</title>\r
4   <para />\r
5   <section id="Imageviewing">\r
6     <title>Image viewing</title>\r
7     <para />\r
8     <section id="HowdoIkeepimagessmallerthanthevisibleareafromenlargingwhenthezoomissettofittowindow">\r
9       <title>How do I keep images smaller than the visible area from enlarging when the zoom is set to “fit to window” ?</title>\r
10       <para>\r
11         In the\r
12         <link linkend="GuideOptionsImage">Preferences Image dialog</link>\r
13         , disable “Allow enlargement of image for zoom to fit”.\r
14       </para>\r
15       <para />\r
16     </section>\r
17   </section>\r
18   <section id="Commandline">\r
19     <title>Command line</title>\r
20     <para />\r
21     <section id="HowdoIopenanimageinanexistingGeeqieapplication">\r
22       <title>How do I open an image in an existing Geeqie application ?</title>\r
23       <para>Use the “--remote” command line option to send commands to an existing Geeqie, for a list of commands supported by the remote switch run:</para>\r
24       <programlisting>geeqie --remote-help</programlisting>\r
25       <para />\r
26     </section>\r
27     <section id="HowdoIsettheslideshowdelaywhenstartingGeeqieinslideshowfromthecommandline">\r
28       <title>How do I set the slide show delay when starting Geeqie in slide show from the command line ?</title>\r
29       <para>The delay can not be set when used with the standard --slideshow command line switch, as --slideshow uses the delay stored in the configuration file.</para>\r
30       <para>For this, use the remote command --slideshow-start to start the slide show after setting the delay with --delay=. The order of the command line is important. For example for a 12 second slide show delay use:</para>\r
31       <programlisting>geeqie --remote  --delay=12 --slideshow-start</programlisting>\r
32       <para>Note that if geeqie is running prior to this command, the slide show should also be stopped prior to changing the delay:</para>\r
33       <programlisting>geeqie --remote --slideshow-stop --delay=12 --slideshow-start</programlisting>\r
34       <para />\r
35     </section>\r
36   </section>\r
37   <section id="Miscellaneous">\r
38     <title>Miscellaneous</title>\r
39     <para />\r
40     <section id="OpenCloseMultipleWindows">\r
41       <title>How can I save and restore multiple Geeqie windows</title>\r
42       <para>\r
43         The option\r
44         <link linkend="titleGuideOptionsLayout">Exit program when this window is closed</link>\r
45         provides this facility.\r
46       </para>\r
47       <para />\r
48     </section>\r
49     <section id="IwanttobeabletoeditimageswithGeeqie">\r
50       <title>I want to be able to edit images with Geeqie</title>\r
51       <para>\r
52         Geeqie is an image\r
53         <emphasis role="i">viewer</emphasis>\r
54         . There is, and never will be, a plan to add editing features. I recommend gimp for image editing.\r
55       </para>\r
56       <para />\r
57     </section>\r
58   </section>\r
59   <section id="ExifRotation">\r
60     <title>Exif Auto Rotation</title>\r
61     <para />\r
62     <section id="HowdotheExifauto-rotationcommandswork">\r
63       <title>How do the Exif auto-rotation commands work?</title>\r
64       <para>\r
65         Image auto-rotation works in either of two modes, set by\r
66         <link linkend="MetadataMiscellaneous">Write altered image orientation to the metadata</link>\r
67         option.\r
68       </para>\r
69       <para>\r
70         <emphasis role="bold">Write altered image orientation to the metadata - not set:</emphasis>\r
71         <para />\r
72         If you change the orientation of an image using any of the available commands, the image will always be displayed in the modified orientation. This new orientation is stored in temporary data structures associated with each image file. When Geeqie closes, these changes will be lost.\r
73       </para>\r
74       <warning>\r
75         <para>It is not possible to determine if the image as displayed is the original image or one which has been temporarily rotated.</para>\r
76       </warning>\r
77       <para>\r
78         If the option\r
79         <link linkend="Editmenu">Auto rotate image using EXIF information</link>\r
80         is selected, any images which have Exif orientation data will also be shown rotated. However, any rotation you have selected manually will always over-ride the embedded Exif rotation value.\r
81       </para>\r
82       <para>\r
83         <emphasis role="bold">Write altered image orientation to the metadata - set:</emphasis>\r
84         <para />\r
85         <para>If you change the orientation of an image using any of the available commands, this new orientation is stored in a metadata write queue.</para>\r
86         <para>\r
87           If the option\r
88           <link linkend="Editmenu">Auto rotate image using EXIF information</link>\r
89           is selected, any images which have Exif orientation data will be shown rotated, including any in the metadata write queue.\r
90         </para>\r
91         <para>\r
92           However if the option\r
93           <link linkend="Editmenu">Auto rotate image using EXIF information</link>\r
94           is not selected, no images will be auto-rotated. If you have manually rotated any images, the metadata write icon on the status bar will alert you to that fact. Clicking the icon will give a list of the modified files.\r
95         </para>\r
96       </para>\r
97       <para />\r
98     </section>\r
99   </section>\r
100 </chapter>\r