dropped references to OpenOffice.org as suggested at
[geeqie.git] / doc / 5_2_finding_duplicates.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>Finding Duplicates - GQview User Manual</TITLE>
6         <META NAME="CREATED" CONTENT="20040805;23590500">
7         <META NAME="CHANGED" CONTENT="20041227;15451200">
8 </HEAD>
9 <BODY LANG="en-US" DIR="LTR">
10 <CENTER>
11         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
12                 <COL WIDTH=85*>
13                 <COL WIDTH=85*>
14                 <COL WIDTH=85*>
15                 <THEAD>
16                         <TR VALIGN=TOP>
17                                 <TD WIDTH=33%>
18                                         <P><A HREF="5_1_search.html">Previous</A></P>
19                                 </TD>
20                                 <TD WIDTH=33%>
21                                         <P ALIGN=CENTER>Finding Duplicates - Image Search</P>
22                                 </TD>
23                                 <TD WIDTH=33%>
24                                         <P ALIGN=RIGHT><A HREF="6_collections.html">Next</A></P>
25                                 </TD>
26                         </TR>
27                 </THEAD>
28         </TABLE>
29 </CENTER>
30 <HR>
31 <H1>5.2 Finding Duplicates</H1>
32 <P>GQview provides a utility to find images that have similar
33 attributes or content.</P>
34 <P>To display a new Find Duplicates Window press D or select Find
35 duplicates from the File menu.</P>
36 <P><BR><BR>
37 </P>
38 <P><U>Adding files to be compared</U></P>
39 <P STYLE="margin-left: 0.79in">Add files to be compared using drag
40 and drop. Drop files or folders onto the Find Duplicates window to
41 add them to the list of files to compare. When one or more folders
42 are dropped onto the window a menu will appear allowing you to choose
43 the desired action:</P>
44 <P STYLE="margin-left: 1.58in"><B>Add contents:</B> The contents of
45 dropped folders will added to the window. <BR><B>Add contents
46 recursive:</B> The contents of dropped folders and all sub folders
47 will be added to the window.<BR><B>Skip folders:</B> Ignore folders
48 contained in the drop list.</P>
49 <P STYLE="margin-left: 0.79in">When files are added to the window,
50 the comparison is restarted to include the new files.</P>
51 <P><BR><BR>
52 </P>
53 <P><U>Comparison methods</U></P>
54 <P STYLE="margin-left: 0.79in">The attribute to use for two images to
55 match can be selected with the &ldquo;Compare by:&rdquo; drop down
56 menu. Each method is explained below:</P>
57 <P STYLE="margin-left: 0.79in"><B>Name:</B> The file name.</P>
58 <P STYLE="margin-left: 0.79in"><B>Size:</B> The file size.</P>
59 <P STYLE="margin-left: 0.79in"><B>Date:</B> The file date.</P>
60 <P STYLE="margin-left: 0.79in"><B>Dimensions:</B> The image
61 dimensions.</P>
62 <P STYLE="margin-left: 0.79in"><B>Checksum:</B> The MD5 file
63 checksum.</P>
64 <P STYLE="margin-left: 0.79in"><B>Path:</B> The complete path to
65 file.</P>
66 <P STYLE="margin-left: 0.79in"><B>Similarity (high):</B> Very similar
67 image content.</P>
68 <P STYLE="margin-left: 0.79in"><B>Similarity:</B> Similar image
69 content.</P>
70 <P STYLE="margin-left: 0.79in"><B>Similarity (low):</B> Slightly
71 similar image content.</P>
72 <P STYLE="margin-left: 0.79in"><B>Similarity (custom):</B> Similar
73 image content, the value to use to consider two images a match is
74 configured in the <A HREF="10_6_advanced.html">Advanced tab</A> of
75 the preferences dialog by setting the &ldquo;Custom similarity
76 threshold&rdquo;.</P>
77 <P><BR><BR>
78 </P>
79 <P><U>Results list</U></P>
80 <P STYLE="margin-left: 0.79in">Files that match with the selected
81 comparison method will appear in the list. Matching files are grouped
82 in alternating color.</P>
83 <P STYLE="margin-left: 0.79in">The order of the result list can not
84 be changed, files will appear in the order of the search. When
85 comparing by image content similarity, the matching groups will be
86 sorted by order of rank starting with the files that are most
87 similar.</P>
88 <P STYLE="margin-left: 0.79in">A <B>context menu</B> is available for
89 the result list by right clicking the mouse or pressing the Menu key
90 when a row has the focus.</P>
91 <P STYLE="margin-left: 0.79in"><B>Keyboard shortcuts</B> available in
92 the results list:</P>
93 <CENTER>
94         <TABLE WIDTH=80% BORDER=1 BORDERCOLOR="#cccccc" CELLPADDING=2 CELLSPACING=0>
95                 <COL WIDTH=64*>
96                 <COL WIDTH=64*>
97                 <COL WIDTH=128*>
98                 <TR VALIGN=TOP>
99                         <TD WIDTH=25%>
100                                 <P ALIGN=CENTER><B>Shortcut</B></P>
101                         </TD>
102                         <TD WIDTH=25%>
103                                 <P ALIGN=CENTER><B>Context menu name</B></P>
104                         </TD>
105                         <TD WIDTH=50%>
106                                 <P ALIGN=CENTER><B>Description</B></P>
107                         </TD>
108                 </TR>
109                 <TR VALIGN=TOP>
110                         <TD WIDTH=25%>
111                                 <P ALIGN=CENTER>Enter</P>
112                         </TD>
113                         <TD WIDTH=25%>
114                                 <P ALIGN=CENTER>View</P>
115                         </TD>
116                         <TD WIDTH=50%>
117                                 <P ALIGN=CENTER>Opens selected image in main window.</P>
118                         </TD>
119                 </TR>
120                 <TR VALIGN=TOP>
121                         <TD WIDTH=25%>
122                                 <P ALIGN=CENTER>V</P>
123                         </TD>
124                         <TD WIDTH=25%>
125                                 <P ALIGN=CENTER>View in new window</P>
126                         </TD>
127                         <TD WIDTH=50%>
128                                 <P ALIGN=CENTER>Opens selected image in a new window.</P>
129                         </TD>
130                 </TR>
131                 <TR VALIGN=TOP>
132                         <TD WIDTH=25%>
133                                 <P ALIGN=CENTER>Control + A</P>
134                         </TD>
135                         <TD WIDTH=25%>
136                                 <P ALIGN=CENTER>Select all</P>
137                         </TD>
138                         <TD WIDTH=50%>
139                                 <P ALIGN=CENTER>Selects all images.</P>
140                         </TD>
141                 </TR>
142                 <TR VALIGN=TOP>
143                         <TD WIDTH=25%>
144                                 <P ALIGN=CENTER>Control + Shift + A</P>
145                         </TD>
146                         <TD WIDTH=25%>
147                                 <P ALIGN=CENTER>Select none</P>
148                         </TD>
149                         <TD WIDTH=50%>
150                                 <P ALIGN=CENTER>Clear the image selection.</P>
151                         </TD>
152                 </TR>
153                 <TR>
154                         <TD WIDTH=25% VALIGN=BOTTOM SDVAL="1" SDNUM="1033;">
155                                 <P ALIGN=CENTER>1</P>
156                         </TD>
157                         <TD WIDTH=25% VALIGN=TOP>
158                                 <P ALIGN=CENTER>Select group 1 duplicates</P>
159                         </TD>
160                         <TD WIDTH=50% VALIGN=TOP>
161                                 <P ALIGN=CENTER>Selects the first image from each match group.</P>
162                         </TD>
163                 </TR>
164                 <TR>
165                         <TD WIDTH=25% VALIGN=BOTTOM SDVAL="2" SDNUM="1033;">
166                                 <P ALIGN=CENTER>2</P>
167                         </TD>
168                         <TD WIDTH=25% VALIGN=TOP>
169                                 <P ALIGN=CENTER>Select group 2 duplicates</P>
170                         </TD>
171                         <TD WIDTH=50% VALIGN=TOP>
172                                 <P ALIGN=CENTER>Selects all but the first image from each match
173                                 group.</P>
174                         </TD>
175                 </TR>
176                 <TR VALIGN=TOP>
177                         <TD WIDTH=25%>
178                                 <P ALIGN=CENTER>Control + 1 through<BR>Control + 0</P>
179                         </TD>
180                         <TD WIDTH=25%>
181                                 <P ALIGN=CENTER>Edit sub menu</P>
182                         </TD>
183                         <TD WIDTH=50%>
184                                 <P ALIGN=CENTER>Executes the respective editor command.</P>
185                         </TD>
186                 </TR>
187                 <TR VALIGN=TOP>
188                         <TD WIDTH=25%>
189                                 <P ALIGN=CENTER>Control + P</P>
190                         </TD>
191                         <TD WIDTH=25%>
192                                 <P ALIGN=CENTER>Properties</P>
193                         </TD>
194                         <TD WIDTH=50%>
195                                 <P ALIGN=CENTER>Opens a properties window for selected images.</P>
196                         </TD>
197                 </TR>
198                 <TR VALIGN=TOP>
199                         <TD WIDTH=25%>
200                                 <P ALIGN=CENTER>C</P>
201                         </TD>
202                         <TD WIDTH=25%>
203                                 <P ALIGN=CENTER>Add to new collection</P>
204                         </TD>
205                         <TD WIDTH=50%>
206                                 <P ALIGN=CENTER>Creates a new collection containing the selected
207                                 images.</P>
208                         </TD>
209                 </TR>
210                 <TR VALIGN=TOP>
211                         <TD WIDTH=25%>
212                                 <P ALIGN=CENTER><BR>
213                                 </P>
214                         </TD>
215                         <TD WIDTH=25%>
216                                 <P ALIGN=CENTER>Print</P>
217                         </TD>
218                         <TD WIDTH=50%>
219                                 <P ALIGN=CENTER>Opens a print dialog for selected images.</P>
220                         </TD>
221                 </TR>
222                 <TR VALIGN=TOP>
223                         <TD WIDTH=25%>
224                                 <P ALIGN=CENTER>Control + C</P>
225                         </TD>
226                         <TD WIDTH=25%>
227                                 <P ALIGN=CENTER>Copy</P>
228                         </TD>
229                         <TD WIDTH=50%>
230                                 <P ALIGN=CENTER>Copy selected images.</P>
231                         </TD>
232                 </TR>
233                 <TR VALIGN=TOP>
234                         <TD WIDTH=25%>
235                                 <P ALIGN=CENTER>Control + M</P>
236                         </TD>
237                         <TD WIDTH=25%>
238                                 <P ALIGN=CENTER>Move</P>
239                         </TD>
240                         <TD WIDTH=50%>
241                                 <P ALIGN=CENTER>Move selected images.</P>
242                         </TD>
243                 </TR>
244                 <TR VALIGN=TOP>
245                         <TD WIDTH=25%>
246                                 <P ALIGN=CENTER>Control + R</P>
247                         </TD>
248                         <TD WIDTH=25%>
249                                 <P ALIGN=CENTER>Rename</P>
250                         </TD>
251                         <TD WIDTH=50%>
252                                 <P ALIGN=CENTER>Rename selected images.</P>
253                         </TD>
254                 </TR>
255                 <TR VALIGN=TOP>
256                         <TD WIDTH=25%>
257                                 <P ALIGN=CENTER>Control + D</P>
258                         </TD>
259                         <TD WIDTH=25%>
260                                 <P ALIGN=CENTER>Delete</P>
261                         </TD>
262                         <TD WIDTH=50%>
263                                 <P ALIGN=CENTER>Delete selected images.</P>
264                         </TD>
265                 </TR>
266                 <TR VALIGN=TOP>
267                         <TD WIDTH=25%>
268                                 <P ALIGN=CENTER>Delete</P>
269                         </TD>
270                         <TD WIDTH=25%>
271                                 <P ALIGN=CENTER>Remove</P>
272                         </TD>
273                         <TD WIDTH=50%>
274                                 <P ALIGN=CENTER>Remove selected images from result list.</P>
275                         </TD>
276                 </TR>
277                 <TR VALIGN=TOP>
278                         <TD WIDTH=25%>
279                                 <P ALIGN=CENTER>Control + Delete</P>
280                         </TD>
281                         <TD WIDTH=25%>
282                                 <P ALIGN=CENTER>Clear</P>
283                         </TD>
284                         <TD WIDTH=50%>
285                                 <P ALIGN=CENTER>Cleared the result list.</P>
286                         </TD>
287                 </TR>
288                 <TR VALIGN=TOP>
289                         <TD WIDTH=25%>
290                                 <P ALIGN=CENTER>Menu</P>
291                         </TD>
292                         <TD WIDTH=25%>
293                                 <P ALIGN=CENTER><BR>
294                                 </P>
295                         </TD>
296                         <TD WIDTH=50%>
297                                 <P ALIGN=CENTER>Displays the context menu.</P>
298                         </TD>
299                 </TR>
300                 <TR VALIGN=TOP>
301                         <TD WIDTH=25%>
302                                 <P ALIGN=CENTER>Control + T</P>
303                         </TD>
304                         <TD WIDTH=25%>
305                                 <P ALIGN=CENTER><BR>
306                                 </P>
307                         </TD>
308                         <TD WIDTH=50%>
309                                 <P ALIGN=CENTER>Toggle display of thumbnails.</P>
310                         </TD>
311                 </TR>
312                 <TR VALIGN=TOP>
313                         <TD WIDTH=25%>
314                                 <P ALIGN=CENTER>Control + W</P>
315                         </TD>
316                         <TD WIDTH=25%>
317                                 <P ALIGN=CENTER><BR>
318                                 </P>
319                         </TD>
320                         <TD WIDTH=50%>
321                                 <P ALIGN=CENTER>Close window.</P>
322                         </TD>
323                 </TR>
324         </TABLE>
325 </CENTER>
326 <P STYLE="margin-left: 0.79in"><BR><BR>
327 </P>
328 <P STYLE="margin-left: 0.79in">The <B>selection</B> can be changed
329 using the keyboard and mouse the same as in a <A HREF="2_4_file_pane.html">file
330 pane</A> of the main window.</P>
331 <P STYLE="margin-left: 0.79in">The image Dimensions column of the
332 result list will only contain dimension information when comparing by
333 dimensions, or when the data is easily available from memory or has
334 been read from the cache.</P>
335 <P><BR><BR>
336 </P>
337 <P><U>Status bar</U></P>
338 <P STYLE="margin-left: 0.79in">Along the bottom of the Find
339 Duplicates window is an area that displays the count of files
340 contained in the window, and the number of files in the result list.</P>
341 <P STYLE="margin-left: 0.79in">The status bar will also display the
342 status of an active compare operation using the progress bar. A
343 compare operation involves 2 or 3 stages, depending on the type of
344 comparison. These are the stages in order:</P>
345 <P STYLE="margin-left: 1.58in">1) If necessary, extra data is read
346 into memory for the comparison stage, the progress bar will indicate
347 this stage with text that resembles &ldquo;reading dimensions...&rdquo;,
348 &ldquo;reading checksums...&rdquo;, or &ldquo;reading similarity
349 data...&rdquo;. <BR>2) The images are compared using the selected
350 method, the progress bar will indicate this stage with the text
351 &ldquo;comparing...&rdquo;.<BR>3) The results are sorted for display,
352 the progress bar will indicate this stage with the text &ldquo;sorting...&rdquo;.</P>
353 <P STYLE="margin-left: 0.79in">Stage 1 is only used for the
354 Dimensions, Checksum, and Similarity compare methods.</P>
355 <P STYLE="margin-left: 0.79in">If the time to complete a stage will
356 be significant, an estimated time to completion will also be
357 displayed in the progress bar. The estimated time only refers to the
358 current stage, other stages are not included in the estimate. The
359 time estimate is displayed using the format MINUTES:SECONDS.</P>
360 <P><BR><BR>
361 </P>
362 <P><U>Thumbnails</U></P>
363 <P STYLE="margin-left: 0.79in">Thumbnails can be displayed beside
364 each image in the result list by enabling the Thumbnails check box.</P>
365 <P><BR><BR>
366 </P>
367 <P><U>Compare two file sets</U></P>
368 <P STYLE="margin-left: 0.79in">Sometimes it is useful to compare one
369 group of files to another, different group of files. Enable this
370 check box to compare two groups of files. When enabled a second list
371 will appear, files can be added to this list using the same methods
372 for the main list.</P>
373 <P STYLE="margin-left: 0.79in">When comparing two file sets the
374 results list will display matches between the two lists. For each
375 match group, the first file is always from the main group, and the
376 remaining files are always from the second group.</P>
377 <P><BR><BR>
378 </P>
379 <P><U>Drag and Drop</U></P>
380 <P STYLE="margin-left: 0.79in">Drag and drop can be initiated with
381 the primary or middle mouse buttons. Dragging a file that is selected
382 will include all selected files in the drag. Dragging a file that is
383 not selected will first change the selection to the dragged file, and
384 clear the previous selection.</P>
385 <P><BR><BR>
386 </P>
387 <P><BR><BR>
388 </P>
389 <HR>
390 <CENTER>
391         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
392                 <COL WIDTH=85*>
393                 <COL WIDTH=85*>
394                 <COL WIDTH=85*>
395                 <THEAD>
396                         <TR VALIGN=TOP>
397                                 <TD WIDTH=33%>
398                                         <P><A HREF="5_1_search.html">Previous</A></P>
399                                 </TD>
400                                 <TD WIDTH=33%>
401                                         <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
402                                 </TD>
403                                 <TD WIDTH=33%>
404                                         <P ALIGN=RIGHT><A HREF="6_collections.html">Next</A></P>
405                                 </TD>
406                         </TR>
407                 </THEAD>
408                 <TBODY>
409                         <TR VALIGN=TOP>
410                                 <TD WIDTH=33%>
411                                         <P><BR>
412                                         </P>
413                                 </TD>
414                                 <TD WIDTH=33%>
415                                         <P ALIGN=CENTER><BR>
416                                         </P>
417                                 </TD>
418                                 <TD WIDTH=33%>
419                                         <P ALIGN=RIGHT>GQview User Manual</P>
420                                 </TD>
421                         </TR>
422                 </TBODY>
423         </TABLE>
424 </CENTER>
425 <P STYLE="margin-bottom: 0in"><BR>
426 </P>
427 </BODY>
428 </HTML>