Standardize on Unix LF line terminators
[geeqie.git] / doc / docbook / GuideOtherWindowsPanView.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <section id="GuideOtherWindowsPanView">
3   <title>Pan View</title>
4   <para>
5     This window offers alternative views of the
6     <emphasis role="i">current directory and its children</emphasis>
7     .
8     <para />
9     It may be opened by
10     <menuchoice>
11       <shortcut>
12         <keycombo>
13           <keycap>Ctrl</keycap>
14           <keycap>J</keycap>
15         </keycombo>
16       </shortcut>
17       <guimenu>View</guimenu>
18       <guimenuitem>Pan view</guimenuitem>
19     </menuchoice>
20     .
21     
22     You can pan the view as you pan an image in normal view mode, using left mouse button and drag.
23   </para>
24   <para>A primary mouse button click on any image will display information about the image. Secondary mouse button will show a context menu.</para>
25   <para>
26     The
27     <link linkend="GuideReferenceKeyboardShortcuts" endterm="titleGuideReferenceKeyboardShortcuts" />
28     available are listed in the Reference section.
29   </para>
30   <note>
31     <para>Pan view recursively visits each folder under the specified folder. This can consume considerable computer resources.</para>
32   </note>
33   <para />
34   <section id="Selectafolder">
35     <title>Select a folder</title>
36     <variablelist>
37       <varlistentry>
38         <term>
39           <guilabel>Location</guilabel>
40         </term>
41         <listitem>
42           <para>The initial location is the current Geeqie folder when the Pan view window is opened.</para>
43         </listitem>
44       </varlistentry>
45     </variablelist>
46     <para />
47   </section>
48   <section id="Chooseaviewmode">
49     <title>Choose a view mode</title>
50     <para>A select box let you choose among different view modes:</para>
51     <variablelist>
52       <varlistentry>
53         <term>
54           <guilabel>Timeline</guilabel>
55         </term>
56         <listitem>
57           <para>Shows images grouped by date.</para>
58         </listitem>
59       </varlistentry>
60       <varlistentry>
61         <term>
62           <guilabel>Calendar</guilabel>
63         </term>
64         <listitem>
65           <para>Shows a calendar with the number of images indicated for each day (as dots and number). Left mouse button click will show images in a pop-up.</para>
66         </listitem>
67       </varlistentry>
68       <varlistentry>
69         <term>
70           <guilabel>Folders</guilabel>
71         </term>
72         <listitem>
73           <para>Show images grouped by folder. Each box represents a folder. Parent and children folders are shown as boxes enclosing other boxes.</para>
74         </listitem>
75       </varlistentry>
76       <varlistentry>
77         <term>
78           <guilabel>Folders (flower)</guilabel>
79         </term>
80         <listitem>
81           <para>Show images grouped by folder. Each box represents a folder. Parent folders are linked to children by a line. The top folder is the center of the flower.</para>
82         </listitem>
83       </varlistentry>
84       <varlistentry>
85         <term>
86           <guilabel>Grid</guilabel>
87         </term>
88         <listitem>
89           <para>All images are shown on a grid.</para>
90         </listitem>
91       </varlistentry>
92     </variablelist>
93     <para />
94   </section>
95   <section id="Howeachimageshouldberepresented">
96     <title>How each image should be represented</title>
97     <para>Another select box let you choose the representation of each image:</para>
98     <variablelist>
99       <varlistentry>
100         <term>
101           <guilabel>Dots</guilabel>
102         </term>
103         <listitem>
104           <para>Each image is represented by a dot.</para>
105         </listitem>
106       </varlistentry>
107       <varlistentry>
108         <term>
109           <guilabel>No images</guilabel>
110         </term>
111         <listitem>
112           <para>Each image is represented by a square box.</para>
113         </listitem>
114       </varlistentry>
115       <varlistentry>
116         <term>
117           <guilabel>Small thumbnails</guilabel>
118         </term>
119         <listitem>
120           <para>Each image is represented by a small thumbnail.</para>
121         </listitem>
122       </varlistentry>
123       <varlistentry>
124         <term>
125           <guilabel>Normal thumbnails</guilabel>
126         </term>
127         <listitem>
128           <para>Each image is represented by a normal thumbnail.</para>
129         </listitem>
130       </varlistentry>
131       <varlistentry>
132         <term>
133           <guilabel>Large thumbnails</guilabel>
134         </term>
135         <listitem>
136           <para>Each image is represented by a large thumbnail.</para>
137         </listitem>
138       </varlistentry>
139       <varlistentry>
140         <term>
141           <guilabel>1:10 (10%)</guilabel>
142         </term>
143         <listitem>
144           <para>Each image is represented by reduced image (1/10 of the original's dimensions).</para>
145         </listitem>
146       </varlistentry>
147       <varlistentry>
148         <term>
149           <guilabel>1:4 (25%)</guilabel>
150         </term>
151         <listitem>
152           <para>Each image is represented by reduced image (1/4 of the original's dimensions).</para>
153         </listitem>
154       </varlistentry>
155       <varlistentry>
156         <term>
157           <guilabel>1:3 (33%)</guilabel>
158         </term>
159         <listitem>
160           <para>Each image is represented by reduced image (1/3 of the original's dimensions).</para>
161         </listitem>
162       </varlistentry>
163       <varlistentry>
164         <term>
165           <guilabel>1:2 (50%)</guilabel>
166         </term>
167         <listitem>
168           <para>Each image is represented by reduced image (1/2 of the original's dimensions).</para>
169         </listitem>
170       </varlistentry>
171       <varlistentry>
172         <term>
173           <guilabel>1:1 (100%)</guilabel>
174         </term>
175         <listitem>
176           <para>The original image is shown at its normal dimensions.</para>
177         </listitem>
178       </varlistentry>
179     </variablelist>
180     <para />
181   </section>
182   <section id="Find">
183     <title>Find</title>
184     <para>At the bottom of the window:</para>
185     <variablelist>
186       <varlistentry>
187         <term>
188           <guilabel>Find button</guilabel>
189         </term>
190         <listitem>
191           <para>
192             Shows a text field for image search. One can enter either:
193             <itemizedlist>
194               <listitem>filename or part filename</listitem>
195               <listitem>
196                 file date in any of the following forms, where the separator may one of
197                 <code>/</code>
198                 <code>-</code>
199                 <code>,</code>
200                 <code>.</code>
201                 or a space:
202                 <itemizedlist>
203                   <listitem>yyyy-mm-dd</listitem>
204                   <listitem>yyyy-mm</listitem>
205                   <listitem>yyyy</listitem>
206                 </itemizedlist>
207               </listitem>
208             </itemizedlist>
209             <para />
210             <keycap>Enter</keycap>
211             will start the search, pressing it again will move to the next match. The matched file is made visible and details are shown for it.
212           </para>
213         </listitem>
214       </varlistentry>
215     </variablelist>
216   </section>
217 </section>