Sync to GQview 1.5.9 release.
[geeqie.git] / doc / 6_collections.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <HTML>
3 <HEAD>
4         <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
5         <TITLE>Collections - GQview User Manual</TITLE>
6         <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.0  (Linux)">
7         <META NAME="CREATED" CONTENT="20040805;23590500">
8         <META NAME="CHANGED" CONTENT="20050107;1552700">
9 </HEAD>
10 <BODY LANG="en-US" DIR="LTR">
11 <CENTER>
12         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
13                 <COL WIDTH=85*>
14                 <COL WIDTH=85*>
15                 <COL WIDTH=85*>
16                 <THEAD>
17                         <TR VALIGN=TOP>
18                                 <TD WIDTH=33%>
19                                         <P><A HREF="5_2_finding_duplicates.html">Previous</A></P>
20                                 </TD>
21                                 <TD WIDTH=33%>
22                                         <P ALIGN=CENTER>Collections</P>
23                                 </TD>
24                                 <TD WIDTH=33%>
25                                         <P ALIGN=RIGHT><A HREF="7_sidebars.html">Next</A></P>
26                                 </TD>
27                         </TR>
28                 </THEAD>
29         </TABLE>
30 </CENTER>
31 <HR>
32 <H1>6. Collections</H1>
33 <P>GQview provides the ability to build lists of images, regardless
34 of the location of the files on disk.</P>
35 <P><BR><BR>
36 </P>
37 <P STYLE="margin-top: 0.17in; page-break-after: avoid"><FONT FACE="Albany, sans-serif"><FONT SIZE=4>The
38 collection window</FONT></FONT></P>
39 <P>A collection window displays the contents of a collection. It
40 allows the collection to be modified and access to the images
41 contained in the collection.</P>
42 <P>To open a new empty collection window press C or select New
43 collection from the file menu.</P>
44 <P>To open an existing collection, press O or select Open collection
45 from the file menu. A dialog will appear requesting the location of
46 the collection file. A window will the open containing the selected
47 collection. Recently opened or saved collections can also be opened
48 by selecting the collection's file name from the Open recent sub menu
49 of the file menu.</P>
50 <P>The collection window consists of a pane to display the contents
51 of the collection, and a status bar along the bottom of the window.</P>
52 <P><U>Icon pane</U></P>
53 <P STYLE="margin-left: 0.79in">The icon pane displays images
54 contained in the collection as thumbnails in a grid, by default the
55 file names also appear below each thumbnail.</P>
56 <P STYLE="margin-left: 0.79in">The Icon pane works exactly like the
57 Icon view mode of the <A HREF="2_4_file_pane.html">file pane</A> in a
58 main window. But with the addition that the contents of the
59 collection can be organized with drag and drop.</P>
60 <P STYLE="margin-left: 0.79in">A <B>context menu</B> is available for
61 the icon pane by right clicking the mouse or pressing the Menu key.</P>
62 <P STYLE="margin-left: 0.79in"><B>Keyboard shortcuts</B> available in
63 the collection window:</P>
64 <CENTER>
65         <TABLE WIDTH=80% BORDER=1 BORDERCOLOR="#cccccc" CELLPADDING=2 CELLSPACING=0>
66                 <COL WIDTH=64*>
67                 <COL WIDTH=64*>
68                 <COL WIDTH=128*>
69                 <TR VALIGN=TOP>
70                         <TD WIDTH=25%>
71                                 <P ALIGN=CENTER><B>Shortcut</B></P>
72                         </TD>
73                         <TD WIDTH=25%>
74                                 <P ALIGN=CENTER><B>Context menu name</B></P>
75                         </TD>
76                         <TD WIDTH=50%>
77                                 <P ALIGN=CENTER><B>Description</B></P>
78                         </TD>
79                 </TR>
80                 <TR VALIGN=TOP>
81                         <TD WIDTH=25%>
82                                 <P ALIGN=CENTER>Enter</P>
83                         </TD>
84                         <TD WIDTH=25%>
85                                 <P ALIGN=CENTER>View</P>
86                         </TD>
87                         <TD WIDTH=50%>
88                                 <P ALIGN=CENTER>Opens selected image in main window.</P>
89                         </TD>
90                 </TR>
91                 <TR VALIGN=TOP>
92                         <TD WIDTH=25%>
93                                 <P ALIGN=CENTER>V</P>
94                         </TD>
95                         <TD WIDTH=25%>
96                                 <P ALIGN=CENTER>View in new window</P>
97                         </TD>
98                         <TD WIDTH=50%>
99                                 <P ALIGN=CENTER>Opens selected image in a new window.</P>
100                         </TD>
101                 </TR>
102                 <TR VALIGN=TOP>
103                         <TD WIDTH=25%>
104                                 <P ALIGN=CENTER>Control + A</P>
105                         </TD>
106                         <TD WIDTH=25%>
107                                 <P ALIGN=CENTER>Select all</P>
108                         </TD>
109                         <TD WIDTH=50%>
110                                 <P ALIGN=CENTER>Selects all images.</P>
111                         </TD>
112                 </TR>
113                 <TR VALIGN=TOP>
114                         <TD WIDTH=25%>
115                                 <P ALIGN=CENTER>Control + Shift + A</P>
116                         </TD>
117                         <TD WIDTH=25%>
118                                 <P ALIGN=CENTER>Select none</P>
119                         </TD>
120                         <TD WIDTH=50%>
121                                 <P ALIGN=CENTER>Clear the image selection.</P>
122                         </TD>
123                 </TR>
124                 <TR VALIGN=TOP>
125                         <TD WIDTH=25%>
126                                 <P ALIGN=CENTER>Control + 1 through<BR>Control + 0</P>
127                         </TD>
128                         <TD WIDTH=25%>
129                                 <P ALIGN=CENTER>Edit sub menu</P>
130                         </TD>
131                         <TD WIDTH=50%>
132                                 <P ALIGN=CENTER>Executes the respective editor command.</P>
133                         </TD>
134                 </TR>
135                 <TR VALIGN=TOP>
136                         <TD WIDTH=25%>
137                                 <P ALIGN=CENTER>Control + P</P>
138                         </TD>
139                         <TD WIDTH=25%>
140                                 <P ALIGN=CENTER>Properties</P>
141                         </TD>
142                         <TD WIDTH=50%>
143                                 <P ALIGN=CENTER>Opens a properties window for selected images.</P>
144                         </TD>
145                 </TR>
146                 <TR VALIGN=TOP>
147                         <TD WIDTH=25%>
148                                 <P ALIGN=CENTER>Control + C</P>
149                         </TD>
150                         <TD WIDTH=25%>
151                                 <P ALIGN=CENTER>Copy</P>
152                         </TD>
153                         <TD WIDTH=50%>
154                                 <P ALIGN=CENTER>Copy selected images.</P>
155                         </TD>
156                 </TR>
157                 <TR VALIGN=TOP>
158                         <TD WIDTH=25%>
159                                 <P ALIGN=CENTER>Control + M</P>
160                         </TD>
161                         <TD WIDTH=25%>
162                                 <P ALIGN=CENTER>Move</P>
163                         </TD>
164                         <TD WIDTH=50%>
165                                 <P ALIGN=CENTER>Move selected images.</P>
166                         </TD>
167                 </TR>
168                 <TR VALIGN=TOP>
169                         <TD WIDTH=25%>
170                                 <P ALIGN=CENTER>Control + R</P>
171                         </TD>
172                         <TD WIDTH=25%>
173                                 <P ALIGN=CENTER>Rename</P>
174                         </TD>
175                         <TD WIDTH=50%>
176                                 <P ALIGN=CENTER>Rename selected images.</P>
177                         </TD>
178                 </TR>
179                 <TR VALIGN=TOP>
180                         <TD WIDTH=25%>
181                                 <P ALIGN=CENTER>Control + D</P>
182                         </TD>
183                         <TD WIDTH=25%>
184                                 <P ALIGN=CENTER>Delete</P>
185                         </TD>
186                         <TD WIDTH=50%>
187                                 <P ALIGN=CENTER>Delete selected images.</P>
188                         </TD>
189                 </TR>
190                 <TR VALIGN=TOP>
191                         <TD WIDTH=25%>
192                                 <P ALIGN=CENTER>Delete</P>
193                         </TD>
194                         <TD WIDTH=25%>
195                                 <P ALIGN=CENTER>Remove</P>
196                         </TD>
197                         <TD WIDTH=50%>
198                                 <P ALIGN=CENTER>Remove selected images from result list.</P>
199                         </TD>
200                 </TR>
201                 <TR VALIGN=TOP>
202                         <TD WIDTH=25%>
203                                 <P ALIGN=CENTER>Control + L</P>
204                         </TD>
205                         <TD WIDTH=25%>
206                                 <P ALIGN=CENTER>Append from file list</P>
207                         </TD>
208                         <TD WIDTH=50%>
209                                 <P ALIGN=CENTER>Add contents of main window to collection.</P>
210                         </TD>
211                 </TR>
212                 <TR VALIGN=TOP>
213                         <TD WIDTH=25%>
214                                 <P ALIGN=CENTER>A</P>
215                         </TD>
216                         <TD WIDTH=25%>
217                                 <P ALIGN=CENTER>Append from collection</P>
218                         </TD>
219                         <TD WIDTH=50%>
220                                 <P ALIGN=CENTER>Append contents of another collection from a
221                                 file.</P>
222                         </TD>
223                 </TR>
224                 <TR VALIGN=TOP>
225                         <TD WIDTH=25%>
226                                 <P ALIGN=CENTER>S</P>
227                         </TD>
228                         <TD WIDTH=25%>
229                                 <P ALIGN=CENTER>Save collection</P>
230                         </TD>
231                         <TD WIDTH=50%>
232                                 <P ALIGN=CENTER>Save collection to disk, if the collection is new
233                                 a dialog will appear to select the file name and location.</P>
234                         </TD>
235                 </TR>
236                 <TR VALIGN=TOP>
237                         <TD WIDTH=25%>
238                                 <P ALIGN=CENTER>Control + S</P>
239                         </TD>
240                         <TD WIDTH=25%>
241                                 <P ALIGN=CENTER>Save collection as</P>
242                         </TD>
243                         <TD WIDTH=50%>
244                                 <P ALIGN=CENTER>Opens a dialog to select a new file name to use
245                                 for the collection.</P>
246                         </TD>
247                 </TR>
248                 <TR VALIGN=TOP>
249                         <TD WIDTH=25%>
250                                 <P ALIGN=CENTER>Control + T</P>
251                         </TD>
252                         <TD WIDTH=25%>
253                                 <P ALIGN=CENTER>Show filename text</P>
254                         </TD>
255                         <TD WIDTH=50%>
256                                 <P ALIGN=CENTER>Toggle display of text below icons.</P>
257                         </TD>
258                 </TR>
259                 <TR VALIGN=TOP>
260                         <TD WIDTH=25%>
261                                 <P ALIGN=CENTER>Menu</P>
262                         </TD>
263                         <TD WIDTH=25%>
264                                 <P ALIGN=CENTER><BR>
265                                 </P>
266                         </TD>
267                         <TD WIDTH=50%>
268                                 <P ALIGN=CENTER>Displays the context menu.</P>
269                         </TD>
270                 </TR>
271                 <TR VALIGN=TOP>
272                         <TD WIDTH=25%>
273                                 <P ALIGN=CENTER>N</P>
274                         </TD>
275                         <TD WIDTH=25%>
276                                 <P ALIGN=CENTER>Sort by name</P>
277                         </TD>
278                         <TD WIDTH=50%>
279                                 <P ALIGN=CENTER>Sort collection by file name.</P>
280                         </TD>
281                 </TR>
282                 <TR VALIGN=TOP>
283                         <TD WIDTH=25%>
284                                 <P ALIGN=CENTER>I</P>
285                         </TD>
286                         <TD WIDTH=25%>
287                                 <P ALIGN=CENTER>Sort by number</P>
288                         </TD>
289                         <TD WIDTH=50%>
290                                 <P ALIGN=CENTER>Sort collection by file name, using natural
291                                 numerical order</P>
292                         </TD>
293                 </TR>
294                 <TR VALIGN=TOP>
295                         <TD WIDTH=25%>
296                                 <P ALIGN=CENTER>D</P>
297                         </TD>
298                         <TD WIDTH=25%>
299                                 <P ALIGN=CENTER>Sort by date</P>
300                         </TD>
301                         <TD WIDTH=50%>
302                                 <P ALIGN=CENTER>Sort collection by file date.</P>
303                         </TD>
304                 </TR>
305                 <TR VALIGN=TOP>
306                         <TD WIDTH=25%>
307                                 <P ALIGN=CENTER>B</P>
308                         </TD>
309                         <TD WIDTH=25%>
310                                 <P ALIGN=CENTER>Sort by size</P>
311                         </TD>
312                         <TD WIDTH=50%>
313                                 <P ALIGN=CENTER>Sort collection by file size.</P>
314                         </TD>
315                 </TR>
316                 <TR VALIGN=TOP>
317                         <TD WIDTH=25%>
318                                 <P ALIGN=CENTER>P</P>
319                         </TD>
320                         <TD WIDTH=25%>
321                                 <P ALIGN=CENTER>Sort by path</P>
322                         </TD>
323                         <TD WIDTH=50%>
324                                 <P ALIGN=CENTER>Sort collection by file location (path to file).</P>
325                         </TD>
326                 </TR>
327                 <TR VALIGN=TOP>
328                         <TD WIDTH=25%>
329                                 <P ALIGN=CENTER><BR>
330                                 </P>
331                         </TD>
332                         <TD WIDTH=25%>
333                                 <P ALIGN=CENTER>Print</P>
334                         </TD>
335                         <TD WIDTH=50%>
336                                 <P ALIGN=CENTER>Opens a print dialog for selected images.</P>
337                         </TD>
338                 </TR>
339                 <TR VALIGN=TOP>
340                         <TD WIDTH=25%>
341                                 <P ALIGN=CENTER>Control + W</P>
342                         </TD>
343                         <TD WIDTH=25%>
344                                 <P ALIGN=CENTER><BR>
345                                 </P>
346                         </TD>
347                         <TD WIDTH=50%>
348                                 <P ALIGN=CENTER>Close window.</P>
349                         </TD>
350                 </TR>
351         </TABLE>
352 </CENTER>
353 <P><BR><BR>
354 </P>
355 <P STYLE="margin-left: 0.79in">The <B>selection</B> can be changed
356 using the keyboard and mouse the same as in a <A HREF="2_4_file_pane.html">file
357 pane</A> of the main window.</P>
358 <P><BR><BR>
359 </P>
360 <P><U>Status bar</U></P>
361 <P STYLE="margin-left: 0.79in">The status bar displays the total
362 number of images in the collection, and the number of selected images
363 in parenthesis. A progress bar also displays whenever thumbnails are
364 loading from disk.</P>
365 <P><BR><BR>
366 </P>
367 <P><U>Drag and Drop</U></P>
368 <P STYLE="margin-left: 0.79in">Drag and drop can be initialized with
369 the primary or middle mouse buttons. Dragging an image that is
370 selected will include all selected images in the drag. Dragging an
371 image that is not selected will drag only that image.</P>
372 <P STYLE="margin-left: 0.79in">Dropping files and folders onto the
373 collection window will add them to the collection, they will be
374 inserted at the location of the drop. A red arrow will indicate the
375 location of the drop as files are dragged over the collection window.
376 When one or more folders are included in the drop list, a menu will
377 appear to select how to handle the contents of the folders.</P>
378 <P STYLE="margin-left: 0.79in">To move images within the collection
379 to change their order, initiate a drag for the selected image(s) and
380 then move the mouse to the desired location within the window. A red
381 arrow will appear to assist in determining the destination of the
382 dragged images. Release the drag to move the images to the new
383 location in the list.</P>
384 <P><BR><BR>
385 </P>
386 <P>Note: When renaming or moving files within GQview, the contents of
387 collections located in the folder ($HOME)/.gqview/collections will
388 automatically update to the new name or location.</P>
389 <P><BR><BR>
390 </P>
391 <HR>
392 <CENTER>
393         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
394                 <COL WIDTH=85*>
395                 <COL WIDTH=85*>
396                 <COL WIDTH=85*>
397                 <THEAD>
398                         <TR VALIGN=TOP>
399                                 <TD WIDTH=33%>
400                                         <P><A HREF="5_2_finding_duplicates.html">Previous</A></P>
401                                 </TD>
402                                 <TD WIDTH=33%>
403                                         <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
404                                 </TD>
405                                 <TD WIDTH=33%>
406                                         <P ALIGN=RIGHT><A HREF="7_sidebars.html">Next</A></P>
407                                 </TD>
408                         </TR>
409                 </THEAD>
410                 <TBODY>
411                         <TR VALIGN=TOP>
412                                 <TD WIDTH=33%>
413                                         <P><BR>
414                                         </P>
415                                 </TD>
416                                 <TD WIDTH=33%>
417                                         <P ALIGN=CENTER><BR>
418                                         </P>
419                                 </TD>
420                                 <TD WIDTH=33%>
421                                         <P ALIGN=RIGHT>GQview User Manual</P>
422                                 </TD>
423                         </TR>
424                 </TBODY>
425         </TABLE>
426 </CENTER>
427 <P STYLE="margin-bottom: 0in"><BR>
428 </P>
429 </BODY>
430 </HTML>