255fc6070344fdee66f303d9c8d16dc5526eee08
[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 setting. 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 setting. Each section is described below.</para>\r
6   <para />\r
7   <section id="ProgressBar">\r
8     <title>Progress Bar</title>\r
9     <para>The Progress bar updates to display the current state of thumbnail generation. When this section contains no text, thumbnail generation is idle. 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.</para>\r
10     <para />\r
11   </section>\r
12   <section id="Sortmethod">\r
13     <title>Sort method</title>\r
14     <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
15     <variablelist>\r
16       <varlistentry>\r
17         <term>\r
18           <guilabel>Name</guilabel>\r
19         </term>\r
20         <listitem>\r
21           <para>Images are sorted by file name.</para>\r
22         </listitem>\r
23       </varlistentry>\r
24       <varlistentry>\r
25         <term>\r
26           <guilabel>Number</guilabel>\r
27         </term>\r
28         <listitem>\r
29           <para>Images are sorted by natural numerical order, such that, for example, 9_name.jpg will be listed before 10_name.jpg.</para>\r
30         </listitem>\r
31       </varlistentry>\r
32       <varlistentry>\r
33         <term>\r
34           <guilabel>Date</guilabel>\r
35         </term>\r
36         <listitem>\r
37           <para>Images are sorted by file modification date.</para>\r
38         </listitem>\r
39       </varlistentry>\r
40       <varlistentry>\r
41         <term>\r
42           <guilabel>File Creation Date</guilabel>\r
43         </term>\r
44         <listitem>\r
45           <para>Images are sorted by file creation date.</para>\r
46         </listitem>\r
47       </varlistentry>\r
48       <varlistentry>\r
49         <term>\r
50           <guilabel>Exif Date</guilabel>\r
51         </term>\r
52         <listitem>\r
53           <para>Images are sorted by file Exif date.</para>\r
54         </listitem>\r
55       </varlistentry>\r
56       <varlistentry>\r
57         <term>\r
58           <guilabel>Size</guilabel>\r
59         </term>\r
60         <listitem>\r
61           <para>Image are sorted by file size on disk.</para>\r
62         </listitem>\r
63       </varlistentry>\r
64       <varlistentry>\r
65         <term>\r
66           <guilabel>Ascending</guilabel>\r
67         </term>\r
68         <listitem>\r
69           <para>Toggles between increasing and decreasing sort order. A check will appear next to this entry to indicate ascending sort order.</para>\r
70         </listitem>\r
71       </varlistentry>\r
72     </variablelist>\r
73     <para />\r
74   </section>\r
75   <section id="Filelist">\r
76     <title>File list</title>\r
77     <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
78     <para />\r
79   </section>\r
80   <section id="ImageDetails">\r
81     <title>Image Details</title>\r
82     <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 permision)” may appear if the file permissions do not allow reading the contents of the file.</para>\r
83     <para />\r
84   </section>\r
85   <section id="Zoom">\r
86     <title>Zoom</title>\r
87     <para>This section 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
88     <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
89     <para />\r
90   </section>\r
91   <section id="Buttons">\r
92     <title>Buttons</title>\r
93     <para>Statusbar buttons corresponds to selected menu action.</para>\r
94     <para />\r
95     <section id="ExifRotate">\r
96       <title>Exif rotate</title>\r
97       <para>\r
98         <guiicon>\r
99           <inlinegraphic fileref="gtk-color-picker.png" />\r
100         </guiicon>\r
101         Toggles the auto-rotation of images if they have Exif orientation data. \r
102         Refer also to the\r
103         <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>\r
104         .\r
105       </para>\r
106       <para />\r
107     </section>\r
108     <section id="ShowPixelInfo">\r
109       <title>Show Pixel Info</title>\r
110       <para>\r
111         <guiicon>\r
112           <inlinegraphic fileref="gtk-color-picker.png" />\r
113         </guiicon>\r
114         Shows coordinates and RGB value under cursor.\r
115       </para>\r
116       <para />\r
117     </section>\r
118     <section id="EnableColorManagement">\r
119       <title>Enable Color Management</title>\r
120       <para>\r
121         <guiicon>\r
122           <inlinegraphic fileref="gtk-select-color.png" />\r
123         </guiicon>\r
124         Enables color profiles.\r
125       </para>\r
126       <para />\r
127     </section>\r
128     <section id="SaveMetadata">\r
129       <title>Save Metadata</title>\r
130       <para>\r
131         <guiicon>\r
132           <inlinegraphic fileref="document-save.png" />\r
133         </guiicon>\r
134         Opens dialog for review and saving of metadata changes.\r
135       </para>\r
136       <para />\r
137     </section>\r
138   </section>\r
139 </section>\r