Add Connected zoom and Split menu items.
[geeqie.git] / doc / collections.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
8
9   <title>Collections - Geeqie User Manual</title>
10   <link rel="stylesheet" type="text/css" href="style.css" />
11 </head>
12
13 <body lang="en-US" dir="ltr">
14   <div class="navtop">
15     <table width="100%" border="0" cellpadding="4" cellspacing="0">
16       <col id="navtop_col1" width="33%"></col>
17       <col id="navtop_col2" width="33%"></col>
18       <col id="navtop_col3" width="33%"></col>
19
20         <tr>
21           <th>
22             <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
23             </p>
24           </th>
25
26           <th>
27             <p class="navtop_title">Collections</p>
28           </th>
29
30           <th>
31             <p class="next"><a href="sidebars.html">Next</a>
32             </p>
33           </th>
34         </tr>
35     </table>
36   </div>
37
38   <hr />
39
40   <h1>Collections</h1>
41
42   <p>Geeqie provides the ability to build lists of images, regardless of the location of the files on disk.</p>
43
44   <h2>The collection window</h2>
45  
46   <p>A collection window displays the contents of a collection. It allows the collection to be modified and access to the images contained in the collection.</p>
47
48   <p>To open a new empty collection window press C or select New collection from the file menu.</p>
49
50   <p>To open an existing collection, press O or select Open collection from the file menu. A dialog will appear requesting the location of the collection file. A window will the open containing the selected collection. Recently opened or saved collections can also be opened by selecting the collection's file name from the Open recent sub menu of the file menu.</p>
51
52   <p>The collection window consists of a pane to display the contents of the collection, and a status bar along the bottom of the window.</p>
53
54   <h3>Icon pane</h3>
55
56   <p>The icon pane displays images contained in the collection as thumbnails in a grid, by default the file names also appear below each thumbnail.</p>
57
58   <p>The Icon pane works exactly like the Icon view mode of the <a href="main_window_file_pane.html">file pane</a> in a main window. But with the addition that the contents of the collection can be organized with drag and drop.</p>
59
60   <p>A <b>context menu</b> is available for the icon pane by right clicking the mouse or pressing the Menu key.</p>
61
62   <p><b>Keyboard shortcuts</b> available in the collection window:</p>
63
64   <div class="collections-shortcuts">
65     <table width="80%" border="1" cellpadding="2" cellspacing="0">
66       <col width="25%"></col>
67       <col width="25%"></col>
68       <col width="50%"></col>
69
70       <thead>
71       <tr>
72         <th>
73           <p>Shortcut</p>
74         </th>
75
76         <th>
77           <p>Context menu name</p>
78         </th>
79
80         <th>
81           <p>Description</p>
82         </th>
83       </tr>
84       </thead>
85
86       <tr>
87         <td>
88           <p>Enter</p>
89         </td>
90
91         <td>
92           <p>View</p>
93         </td>
94
95         <td>
96           <p>Opens selected image in main window.</p>
97         </td>
98       </tr>
99
100       <tr>
101         <td>
102           <p>V</p>
103         </td>
104
105         <td>
106           <p>View in new window</p>
107         </td>
108
109         <td>
110           <p>Opens selected image in a new window.</p>
111         </td>
112       </tr>
113
114       <tr>
115         <td>
116           <p>Control + A</p>
117         </td>
118
119         <td>
120           <p>Select all</p>
121         </td>
122
123         <td>
124           <p>Selects all images.</p>
125         </td>
126       </tr>
127
128       <tr>
129         <td>
130           <p>Control + Shift + A</p>
131         </td>
132
133         <td>
134           <p>Select none</p>
135         </td>
136
137         <td>
138           <p>Clear the image selection.</p>
139         </td>
140       </tr>
141
142       <tr>
143         <td>
144           <p>Control + 1 through<br />
145           Control + 0</p>
146         </td>
147
148         <td>
149           <p>Edit sub menu</p>
150         </td>
151
152         <td>
153           <p>Executes the respective editor command.</p>
154         </td>
155       </tr>
156
157       <tr>
158         <td>
159           <p>Control + P</p>
160         </td>
161
162         <td>
163           <p>Properties</p>
164         </td>
165
166         <td>
167           <p>Opens a properties window for selected images.</p>
168         </td>
169       </tr>
170
171       <tr>
172         <td>
173           <p>Control + C</p>
174         </td>
175
176         <td>
177           <p>Copy</p>
178         </td>
179
180         <td>
181           <p>Copy selected images.</p>
182         </td>
183       </tr>
184
185       <tr>
186         <td>
187           <p>Control + M</p>
188         </td>
189
190         <td>
191           <p>Move</p>
192         </td>
193
194         <td>
195           <p>Move selected images.</p>
196         </td>
197       </tr>
198
199       <tr>
200         <td>
201           <p>Control + R</p>
202         </td>
203
204         <td>
205           <p>Rename</p>
206         </td>
207
208         <td>
209           <p>Rename selected images.</p>
210         </td>
211       </tr>
212
213       <tr>
214         <td>
215           <p>Control + D</p>
216         </td>
217
218         <td>
219           <p>Delete</p>
220         </td>
221
222         <td>
223           <p>Delete selected images.</p>
224         </td>
225       </tr>
226
227       <tr>
228         <td>
229           <p>Delete</p>
230         </td>
231
232         <td>
233           <p>Remove</p>
234         </td>
235
236         <td>
237           <p>Remove selected images from result list.</p>
238         </td>
239       </tr>
240
241       <tr>
242         <td>
243           <p>Control + L</p>
244         </td>
245
246         <td>
247           <p>Append from file list</p>
248         </td>
249
250         <td>
251           <p>Add contents of main window to collection.</p>
252         </td>
253       </tr>
254
255       <tr>
256         <td>
257           <p>A</p>
258         </td>
259
260         <td>
261           <p>Append from collection</p>
262         </td>
263
264         <td>
265           <p>Append contents of another collection from a file.</p>
266         </td>
267       </tr>
268
269       <tr>
270         <td>
271           <p>S</p>
272         </td>
273
274         <td>
275           <p>Save collection</p>
276         </td>
277
278         <td>
279           <p>Save collection to disk, if the collection is new a dialog will appear to select the file name and location.</p>
280         </td>
281       </tr>
282
283       <tr>
284         <td>
285           <p>Control + S</p>
286         </td>
287
288         <td>
289           <p>Save collection as</p>
290         </td>
291
292         <td>
293           <p>Opens a dialog to select a new file name to use for the collection.</p>
294         </td>
295       </tr>
296
297       <tr>
298         <td>
299           <p>Control + T</p>
300         </td>
301
302         <td>
303           <p>Show filename text</p>
304         </td>
305
306         <td>
307           <p>Toggle display of text below icons.</p>
308         </td>
309       </tr>
310
311       <tr>
312         <td>
313           <p>Menu</p>
314         </td>
315
316         <td>&nbsp;</td>
317
318         <td>
319           <p>Displays the context menu.</p>
320         </td>
321       </tr>
322
323       <tr>
324         <td>
325           <p>N</p>
326         </td>
327
328         <td>
329           <p>Sort by name</p>
330         </td>
331
332         <td>
333           <p>Sort collection by file name.</p>
334         </td>
335       </tr>
336
337       <tr>
338         <td>
339           <p>I</p>
340         </td>
341
342         <td>
343           <p>Sort by number</p>
344         </td>
345
346         <td>
347           <p>Sort collection by file name, using natural numerical order</p>
348         </td>
349       </tr>
350
351       <tr>
352         <td>
353           <p>D</p>
354         </td>
355
356         <td>
357           <p>Sort by date</p>
358         </td>
359
360         <td>
361           <p>Sort collection by file date.</p>
362         </td>
363       </tr>
364
365       <tr>
366         <td>
367           <p>B</p>
368         </td>
369
370         <td>
371           <p>Sort by size</p>
372         </td>
373
374         <td>
375           <p>Sort collection by file size.</p>
376         </td>
377       </tr>
378
379       <tr>
380         <td>
381           <p>P</p>
382         </td>
383
384         <td>
385           <p>Sort by path</p>
386         </td>
387
388         <td>
389           <p>Sort collection by file location (path to file).</p>
390         </td>
391       </tr>
392
393       <tr>
394         <td>&nbsp;</td>
395
396         <td>
397           <p>Print</p>
398         </td>
399
400         <td>
401           <p>Opens a print dialog for selected images.</p>
402         </td>
403       </tr>
404
405       <tr>
406         <td>
407           <p>Control + W</p>
408         </td>
409
410         <td>&nbsp;</td>
411
412         <td>
413           <p>Close window.</p>
414         </td>
415       </tr>
416     </table>
417   </div>
418
419   <p>The <b>selection</b> can be changed using the keyboard and mouse the same as in a <a href="main_window_file_pane.html">file pane</a> of the main window.</p>
420
421   <h3>Status bar</h3>
422
423   <p>The status bar displays the total number of images in the collection, and the number of selected images in parenthesis. A progress bar also displays whenever thumbnails are loading from disk.</p>
424
425   <h3>Drag and Drop</h3>
426
427   <p>Drag and drop can be initialized with the primary or middle mouse buttons. Dragging an image that is selected will include all selected images in the drag. Dragging an image that is not selected will drag only that image.</p>
428
429   <p>Dropping files and folders onto the collection window will add them to the collection, they will be inserted at the location of the drop. A red arrow will indicate the location of the drop as files are dragged over the collection window. When one or more folders are included in the drop list, a menu will appear to select how to handle the contents of the folders.</p>
430
431   <p>To move images within the collection to change their order, initiate a drag for the selected image(s) and then move the mouse to the desired location within the window. A red arrow will appear to assist in determining the destination of the dragged images. Release the drag to move the images to the new location in the list.</p>
432
433   <p class="note"><span class="note_label">Note:</span> When renaming or moving files within Geeqie, the contents of collections located in the folder ($HOME)/.geeqie/collections will automatically update to the new name or location.</p>
434
435   <hr id="bottomseparator" />
436
437   <div class="navbottom">
438     <table width="100%" border="0" cellpadding="4" cellspacing="0">
439       <col id="navbottom_col1" width="33%"></col>
440       <col id="navbottom_col2" width="33%"></col>
441       <col id="navbottom_col3" width="33%"></col>
442
443         <tr>
444           <th>
445             <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
446             </p>
447           </th>
448
449           <th>
450             <p class="navbottom_title"><a href="index.html">Contents</a>
451             </p>
452           </th>
453
454           <th>
455             <p class="next"><a href="sidebars.html">Next</a>
456             </p>
457           </th>
458         </tr>
459
460     </table>
461   </div>
462
463   <div class="footer">Geeqie User Manual</div>
464   <div class="bottomspacer">&nbsp;</div>
465 </body>
466 </html>