1d8a62c214dd09468b2492b943e320d7b528b525
[geeqie.git] / doc / collections.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2
3 <html xmlns="http://www.w3.org/1999/xhtml">
4 <head>
5   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
6
7   <title>Collections - Geeqie User Manual</title>
8   <link rel="stylesheet" type="text/css" href="style.css" />
9 </head>
10
11 <body lang="en-US" dir="ltr">
12   <div class="navtop">
13     <table width="100%" border="0" cellpadding="4" cellspacing="0">
14       <col id="navtop_col1" width="33%"></col>
15       <col id="navtop_col2" width="33%"></col>
16       <col id="navtop_col3" width="33%"></col>
17
18       <thead>
19         <tr>
20           <td>
21             <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
22             </p>
23           </td>
24
25           <td>
26             <p class="navtop_title">Collections</p>
27           </td>
28
29           <td>
30             <p class="next"><a href="sidebars.html">Next</a>
31             </p>
32           </td>
33         </tr>
34       </thead>
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   <p><br />
45   <br />
46   </p>
47
48   <h2>The collection window</h2>
49  
50   <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>
51
52   <p>To open a new empty collection window press C or select New collection from the file menu.</p>
53
54   <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>
55
56   <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>
57
58   <h3>Icon pane</h3>
59
60   <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>
61
62   <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>
63
64   <p>A <b>context menu</b> is available for the icon pane by right clicking the mouse or pressing the Menu key.</p>
65
66   <p><b>Keyboard shortcuts</b> available in the collection window:</p>
67
68   <div class="gq-collections-4">
69     <table width="80%" border="1" cellpadding="2" cellspacing="0">
70       <col width="25%"></col>
71       <col width="25%"></col>
72       <col width="50%"></col>
73
74       <thead>
75       <tr>
76         <th>
77           <p>Shortcut</p>
78         </th>
79
80         <th>
81           <p>Context menu name</p>
82         </th>
83
84         <th>
85           <p>Description</p>
86         </th>
87       </tr>
88       </thead>
89
90       <tr>
91         <td>
92           <p>Enter</p>
93         </td>
94
95         <td>
96           <p>View</p>
97         </td>
98
99         <td>
100           <p>Opens selected image in main window.</p>
101         </td>
102       </tr>
103
104       <tr>
105         <td>
106           <p>V</p>
107         </td>
108
109         <td>
110           <p>View in new window</p>
111         </td>
112
113         <td>
114           <p>Opens selected image in a new window.</p>
115         </td>
116       </tr>
117
118       <tr>
119         <td>
120           <p>Control + A</p>
121         </td>
122
123         <td>
124           <p>Select all</p>
125         </td>
126
127         <td>
128           <p>Selects all images.</p>
129         </td>
130       </tr>
131
132       <tr>
133         <td>
134           <p>Control + Shift + A</p>
135         </td>
136
137         <td>
138           <p>Select none</p>
139         </td>
140
141         <td>
142           <p>Clear the image selection.</p>
143         </td>
144       </tr>
145
146       <tr>
147         <td>
148           <p>Control + 1 through<br />
149           Control + 0</p>
150         </td>
151
152         <td>
153           <p>Edit sub menu</p>
154         </td>
155
156         <td>
157           <p>Executes the respective editor command.</p>
158         </td>
159       </tr>
160
161       <tr>
162         <td>
163           <p>Control + P</p>
164         </td>
165
166         <td>
167           <p>Properties</p>
168         </td>
169
170         <td>
171           <p>Opens a properties window for selected images.</p>
172         </td>
173       </tr>
174
175       <tr>
176         <td>
177           <p>Control + C</p>
178         </td>
179
180         <td>
181           <p>Copy</p>
182         </td>
183
184         <td>
185           <p>Copy selected images.</p>
186         </td>
187       </tr>
188
189       <tr>
190         <td>
191           <p>Control + M</p>
192         </td>
193
194         <td>
195           <p>Move</p>
196         </td>
197
198         <td>
199           <p>Move selected images.</p>
200         </td>
201       </tr>
202
203       <tr>
204         <td>
205           <p>Control + R</p>
206         </td>
207
208         <td>
209           <p>Rename</p>
210         </td>
211
212         <td>
213           <p>Rename selected images.</p>
214         </td>
215       </tr>
216
217       <tr>
218         <td>
219           <p>Control + D</p>
220         </td>
221
222         <td>
223           <p>Delete</p>
224         </td>
225
226         <td>
227           <p>Delete selected images.</p>
228         </td>
229       </tr>
230
231       <tr>
232         <td>
233           <p>Delete</p>
234         </td>
235
236         <td>
237           <p>Remove</p>
238         </td>
239
240         <td>
241           <p>Remove selected images from result list.</p>
242         </td>
243       </tr>
244
245       <tr>
246         <td>
247           <p>Control + L</p>
248         </td>
249
250         <td>
251           <p>Append from file list</p>
252         </td>
253
254         <td>
255           <p>Add contents of main window to collection.</p>
256         </td>
257       </tr>
258
259       <tr>
260         <td>
261           <p>A</p>
262         </td>
263
264         <td>
265           <p>Append from collection</p>
266         </td>
267
268         <td>
269           <p>Append contents of another collection from a file.</p>
270         </td>
271       </tr>
272
273       <tr>
274         <td>
275           <p>S</p>
276         </td>
277
278         <td>
279           <p>Save collection</p>
280         </td>
281
282         <td>
283           <p>Save collection to disk, if the collection is new a dialog will appear to select the file name and location.</p>
284         </td>
285       </tr>
286
287       <tr>
288         <td>
289           <p>Control + S</p>
290         </td>
291
292         <td>
293           <p>Save collection as</p>
294         </td>
295
296         <td>
297           <p>Opens a dialog to select a new file name to use for the collection.</p>
298         </td>
299       </tr>
300
301       <tr>
302         <td>
303           <p>Control + T</p>
304         </td>
305
306         <td>
307           <p>Show filename text</p>
308         </td>
309
310         <td>
311           <p>Toggle display of text below icons.</p>
312         </td>
313       </tr>
314
315       <tr>
316         <td>
317           <p>Menu</p>
318         </td>
319
320         <td>
321           <p><br />
322           </p>
323         </td>
324
325         <td>
326           <p>Displays the context menu.</p>
327         </td>
328       </tr>
329
330       <tr>
331         <td>
332           <p>N</p>
333         </td>
334
335         <td>
336           <p>Sort by name</p>
337         </td>
338
339         <td>
340           <p>Sort collection by file name.</p>
341         </td>
342       </tr>
343
344       <tr>
345         <td>
346           <p>I</p>
347         </td>
348
349         <td>
350           <p>Sort by number</p>
351         </td>
352
353         <td>
354           <p>Sort collection by file name, using natural numerical order</p>
355         </td>
356       </tr>
357
358       <tr>
359         <td>
360           <p>D</p>
361         </td>
362
363         <td>
364           <p>Sort by date</p>
365         </td>
366
367         <td>
368           <p>Sort collection by file date.</p>
369         </td>
370       </tr>
371
372       <tr>
373         <td>
374           <p>B</p>
375         </td>
376
377         <td>
378           <p>Sort by size</p>
379         </td>
380
381         <td>
382           <p>Sort collection by file size.</p>
383         </td>
384       </tr>
385
386       <tr>
387         <td>
388           <p>P</p>
389         </td>
390
391         <td>
392           <p>Sort by path</p>
393         </td>
394
395         <td>
396           <p>Sort collection by file location (path to file).</p>
397         </td>
398       </tr>
399
400       <tr>
401         <td>
402           <p><br />
403           </p>
404         </td>
405
406         <td>
407           <p>Print</p>
408         </td>
409
410         <td>
411           <p>Opens a print dialog for selected images.</p>
412         </td>
413       </tr>
414
415       <tr>
416         <td>
417           <p>Control + W</p>
418         </td>
419
420         <td>
421           <p><br />
422           </p>
423         </td>
424
425         <td>
426           <p>Close window.</p>
427         </td>
428       </tr>
429     </table>
430   </div>
431
432   <p><br />
433   <br />
434   </p>
435
436   <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>
437
438   <p><br />
439   <br />
440   </p>
441
442   <h3>Status bar</h3>
443
444   <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>
445
446   <p><br />
447   <br />
448   </p>
449
450   <h3>Drag and Drop</h3>
451
452   <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>
453
454   <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>
455
456   <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>
457
458   <p><br />
459   <br />
460   </p>
461
462   <p>Note: 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>
463
464   <p><br />
465   <br />
466   </p>
467
468   <hr />
469
470   <div class="navbottom">
471     <table width="100%" border="0" cellpadding="4" cellspacing="0">
472       <col id="navbottom_col1" width="33%"></col>
473       <col id="navbottom_col2" width="33%"></col>
474       <col id="navbottom_col3" width="33%"></col>
475
476       <thead>
477         <tr>
478           <td>
479             <p class="previous"><a href="image_search_finding_duplicates.html">Previous</a>
480             </p>
481           </td>
482
483           <td>
484             <p class="navbottom_title"><a href="index.html">Contents</a>
485             </p>
486           </td>
487
488           <td>
489             <p class="next"><a href="sidebars.html">Next</a>
490             </p>
491           </td>
492         </tr>
493       </thead>
494
495     </table>
496   </div>
497
498   <div class="footer">Geeqie User Manual</div>
499   <div class="bottomspacer">&nbsp;</div>
500 </body>
501 </html>