Remove commented out code.
[geeqie.git] / doc / docbook / GuideMainWindowStatusBar.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <section id="GuideMainWindowStatusBar">
3     <title>
4       Status Bar
5     </title>
6     <para>
7       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.
8     </para>
9     <para>
10       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.
11     </para>
12     <para/><section id="ProgressBar"><title>
13       Progress Bar
14     </title>
15     <para>
16       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.
17     </para>
18     <para/></section><section id="Sortmethod"><title>
19       Sort method
20     </title>
21     <para>
22       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.
23     </para>
24     <variablelist><varlistentry><term>
25         Name
26       </term><listitem><para>
27         Images are sorted by file name.
28       </para></listitem></varlistentry><varlistentry><term>
29         Number
30       </term><listitem><para>
31         Images are sorted by natural numerical order, such that, for example, 9_name.jpg will be listed before 10_name.jpg.
32       </para></listitem></varlistentry><varlistentry><term>
33         Date
34       </term><listitem><para>
35         Images are sorted by file date on disk.
36       </para></listitem></varlistentry><varlistentry><term>
37         Size
38       </term><listitem><para>
39         Image are sorted by file size on disk.
40       </para></listitem></varlistentry><varlistentry><term>
41         Ascending
42       </term><listitem><para>
43         Toggles between increasing and decreasing sort order. A check will appear next to this entry to indicate ascending sort order.
44       </para></listitem></varlistentry></variablelist>
45     <para/></section><section id="Filelist"><title>
46       File list
47     </title>
48     <para>
49       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.
50     </para>
51     <para/></section><section id="ImageDetails"><title>
52       Image Details
53     </title>
54     <para>
55       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.
56     </para>
57     <para/></section><section id="Zoom"><title>
58       Zoom
59     </title>
60     <para>
61       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.
62     </para>
63     <para>
64       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).
65     </para>
66     <para/></section><section id="Buttons"><title>
67       Buttons
68     </title>
69     <para>
70       Statusbar buttons corresponds to selected menu action. It is possible to add other actions by editing the <link linkend="GuideReferenceConfig">Configuration file</link>
71     </para>
72     <para/><section id="ShowPixelInfo"><title>
73       Show Pixel Info
74     </title>
75     <para>
76       Shows coordinates and RGB value under cursor.
77     </para>
78     <para/></section><section id="EnableColorManagement"><title>
79       Enable Color Management
80     </title>
81     <para>
82       Enables color profiles.
83     </para>
84     <para/></section><section id="SaveMetadata"><title>
85       Save Metadata
86     </title>
87     <para>
88       Opens dialog for review of metadata changes.
89     </para>
90   <para/></section></section></section>