Fix #852: fixed wrong spelled words
[geeqie.git] / doc / docbook / GuideMainWindowStatusBar.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <section id="GuideMainWindowStatusBar">\r
3   <title id="titleGuideMainWindowStatusBar">Status Bar</title>\r
4   <para>The status bar contains information and details about the contents of the main window. Information displayed includes the progress of generating thumbnails, the number of files in the file list with byte size, the current file selection count including byte size, details about the currently displayed image, and the zoom and image scroll settings. The current sort preference is also displayed, and can be adjusted from the status bar.</para>\r
5   <para>The status bar is comprised of five sections, from left to right these are a progress bar, sort method, file list counts, image details, and zoom and scroll setting. Each section is described below.</para>\r
6   <para />\r
7   <section id="ProgressBar">\r
8     <title>Progress Bar</title>\r
9     <para>\r
10       The Progress bar updates to display the current state of thumbnail generation, or the reading of metadata in the current folder.\r
11       <para />\r
12       When “Loading thumbs...” is displayed, thumbnails are currently being generated when Geeqie is idle; the progress bar will update to display the percentage of thumbnails that are completed.\r
13       <para />\r
14       When “Loading meta...” is displayed, certain metadata is being loaded when Geeqie is idle; the progress bar will update to display the percentage of files that have been read. Refer to\r
15       <link linkend="PreLoadMetadata">Preferences metadata.</link>\r
16     </para>\r
17   </section>\r
18   <section id="Sortmethod">\r
19     <title>Sort method</title>\r
20     <para>This is the method used to sort image names in the file list. Clicking or activating this field will display a menu to allow selection of the sort method.</para>\r
21     <variablelist>\r
22       <varlistentry>\r
23         <term>\r
24           <guilabel>Name</guilabel>\r
25         </term>\r
26         <listitem>\r
27           <para>Images are sorted by file name.</para>\r
28         </listitem>\r
29       </varlistentry>\r
30       <varlistentry>\r
31         <term>\r
32           <guilabel>Number</guilabel>\r
33         </term>\r
34         <listitem>\r
35           <para>Images are sorted by natural numerical order, such that, for example, 9_name.jpg will be listed before 10_name.jpg.</para>\r
36         </listitem>\r
37       </varlistentry>\r
38       <varlistentry>\r
39         <term>\r
40           <guilabel>Date</guilabel>\r
41         </term>\r
42         <listitem>\r
43           <para>Images are sorted by file modification date.</para>\r
44         </listitem>\r
45       </varlistentry>\r
46       <varlistentry>\r
47         <term>\r
48           <guilabel>File Date</guilabel>\r
49         </term>\r
50         <listitem>\r
51           <para>\r
52             Images are sorted by one of four types of file date. They are described in the\r
53             <link linkend="GuideReferenceFileDates">Reference section</link>\r
54             .\r
55           </para>\r
56         </listitem>\r
57       </varlistentry>\r
58       <varlistentry>\r
59         <term>\r
60           <guilabel>Size</guilabel>\r
61         </term>\r
62         <listitem>\r
63           <para>Images are sorted by file size on disk.</para>\r
64         </listitem>\r
65       </varlistentry>\r
66       <varlistentry>\r
67         <term>\r
68           <guilabel>Rating</guilabel>\r
69         </term>\r
70         <listitem>\r
71           <para>Image are sorted by Xmp.xmp.Rating.</para>\r
72         </listitem>\r
73       </varlistentry>\r
74       <varlistentry>\r
75         <term>\r
76           <guilabel>Class</guilabel>\r
77         </term>\r
78         <listitem>\r
79           <para>Image are sorted by class. The class types, and sort order, is:</para>\r
80           <itemizedlist>\r
81             <listitem>Unknown</listitem>\r
82             <listitem>Image</listitem>\r
83             <listitem>Raw Image</listitem>\r
84             <listitem>Video</listitem>\r
85             <listitem>Metadata</listitem>\r
86           </itemizedlist>\r
87         </listitem>\r
88       </varlistentry>\r
89       <varlistentry>\r
90         <term>\r
91           <guilabel>Ascending</guilabel>\r
92         </term>\r
93         <listitem>\r
94           <para>Toggles between increasing and decreasing sort order. A check will appear next to this entry to indicate ascending sort order.</para>\r
95         </listitem>\r
96       </varlistentry>\r
97     </variablelist>\r
98     <note>When images have equal rank, for example in rating or class sorts, within each section images will be sorted by filename.</note>\r
99   </section>\r
100   <section id="Filelist">\r
101     <title>File list</title>\r
102     <para>This section displays the count of files that appear in the file list, including the total byte size. The number of files selected is displayed in parenthesis, including the total byte size of the selected files. The slide show status is also displayed here; when a slide show is running, “Slideshow” will appear, the text will change to “Paused” when a slide show is in the paused state.</para>\r
103     <para />\r
104   </section>\r
105   <section id="ImageDetails">\r
106     <title>Image Details</title>\r
107     <para>This section displays the dimensions (width x height) and file byte size of the image that is active in the image pane. When the format of the file in the image pane can not be determined the dimensions will show as “(0 x 0)”, in addition “(no read permission)” may appear if the file permissions do not allow reading the contents of the file.</para>\r
108     <para />\r
109   </section>\r
110   <section id="ZoomAndScroll">\r
111     <title>Zoom and Scroll</title>\r
112     <para>The button label displays the current zoom ratio. A ratio of 1:1 is the image's original size. When the left number is larger the image is displayed larger than original size, when the right number is larger the image is displayed smaller.</para>\r
113     <para>A tilde (~) appears within the ratio display when the zoom is set to fit the image within the display area. In this zoom mode the ratio is automatically adjusted, and the displayed ratio may not be the actual ratio because the status bar display rounds the actual value to the nearest tenth (0.1).</para>\r
114     <para />\r
115     <para>Clicking this button permits control of the behavior of the zoom and scroll settings used when changing the displayed image.</para>\r
116     <variablelist>\r
117       <varlistentry>\r
118         <term>\r
119           <guilabel>Zoom to original size</guilabel>\r
120         </term>\r
121         <listitem>\r
122           <para>The new image is set to its original size.</para>\r
123         </listitem>\r
124       </varlistentry>\r
125       <varlistentry>\r
126         <term>\r
127           <guilabel>Fit image to window</guilabel>\r
128         </term>\r
129         <listitem>\r
130           <para>The new image's zoom is changed so that the image will fit within the current view area.</para>\r
131         </listitem>\r
132       </varlistentry>\r
133       <varlistentry>\r
134         <term>\r
135           <guilabel>Leave zoom at previous setting</guilabel>\r
136         </term>\r
137         <listitem>\r
138           <para>The zoom setting is unchanged, the new image will be scaled the same as the previous image.</para>\r
139         </listitem>\r
140       </varlistentry>\r
141     </variablelist>\r
142     <variablelist>\r
143       <varlistentry>\r
144         <term>\r
145           <guilabel>Scroll to top left corner</guilabel>\r
146         </term>\r
147         <listitem>\r
148           <para>The new image is displayed from top left corner.</para>\r
149         </listitem>\r
150       </varlistentry>\r
151       <varlistentry>\r
152         <term>\r
153           <guilabel>Scroll to image center</guilabel>\r
154         </term>\r
155         <listitem>\r
156           <para>The new image is centered</para>\r
157         </listitem>\r
158       </varlistentry>\r
159       <varlistentry>\r
160         <term>\r
161           <guilabel>Keep the region from previous image</guilabel>\r
162         </term>\r
163         <listitem>\r
164           <para>The new image is positioned as the previous one, whenever possible.</para>\r
165         </listitem>\r
166       </varlistentry>\r
167     </variablelist>\r
168   </section>\r
169   <section id="Buttons">\r
170     <title>Buttons</title>\r
171     <para>\r
172       The Status bar toolbar buttons, the defaults are shown below, correspond to selected menu action. The buttons displayed may be changed in the\r
173       <link linkend="GuideOptionsToolbar">Toolbar tab of Preferences.</link>\r
174     </para>\r
175     <para />\r
176     <section id="ExifRotate">\r
177       <title>Exif rotate</title>\r
178       <para>\r
179         <guiicon>\r
180           <inlinegraphic fileref="gtk-color-picker.png" />\r
181         </guiicon>\r
182         Toggles the auto-rotation of images if they have Exif orientation data.\r
183         Refer also to the\r
184         <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>\r
185         .\r
186       </para>\r
187       <para />\r
188     </section>\r
189     <section id="ShowPixelInfo">\r
190       <title>Show Pixel Info</title>\r
191       <para>\r
192         <guiicon>\r
193           <inlinegraphic fileref="gtk-color-picker.png" />\r
194         </guiicon>\r
195         Shows coordinates and RGB value under cursor.\r
196       </para>\r
197       <para />\r
198     </section>\r
199     <section id="EnableColorManagement">\r
200       <title>Enable Color Management</title>\r
201       <para>\r
202         <guiicon>\r
203           <inlinegraphic fileref="gtk-select-color.png" />\r
204         </guiicon>\r
205         Enables color profiles.\r
206       </para>\r
207       <para />\r
208     </section>\r
209     <section id="SaveMetadata">\r
210       <title>Save Metadata</title>\r
211       <para>\r
212         <guiicon>\r
213           <inlinegraphic fileref="document-save.png" />\r
214         </guiicon>\r
215         Opens dialog for review and saving of metadata changes.\r
216       </para>\r
217       <para />\r
218     </section>\r
219   </section>\r
220 </section>\r