~vanvugt/ubuntu/oneiric/geeqie/fix-788321

« back to all changes in this revision

Viewing changes to doc/5_1_search.html

  • Committer: Bazaar Package Importer
  • Author(s): Michal Čihař
  • Date: 2008-06-10 08:42:37 UTC
  • Revision ID: james.westby@ubuntu.com-20080610084237-foorlvywoxj92o04
Tags: upstream-1.0~alpha1
Import upstream version 1.0~alpha1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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>Search Window - 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="20041227;15443800">
 
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_image_search.html">Previous</A></P>
 
20
                                </TD>
 
21
                                <TD WIDTH=33%>
 
22
                                        <P ALIGN=CENTER>Search Window - Image Search</P>
 
23
                                </TD>
 
24
                                <TD WIDTH=33%>
 
25
                                        <P ALIGN=RIGHT><A HREF="5_2_finding_duplicates.html">Next</A></P>
 
26
                                </TD>
 
27
                        </TR>
 
28
                </THEAD>
 
29
        </TABLE>
 
30
</CENTER>
 
31
<HR>
 
32
<H1>5.1 Search Window</H1>
 
33
<P>GQview provides a utility to find one or more images based on
 
34
various parameters.</P>
 
35
<P>To display a new Search Window press F3 or select Search from the
 
36
File menu.</P>
 
37
<P><BR><BR>
 
38
</P>
 
39
<P>To start a search activate the Find button. A search in progress
 
40
can be stopped by activating the Stop button.</P>
 
41
<P>The progress of an active search is displayed as a progress bar at
 
42
the bottom of the window. The progress bar will also display the
 
43
total files that match the search parameters, and the total number of
 
44
files searched.</P>
 
45
<P>When a search is completed, the total number of files found and
 
46
their total size will be displayed in the status bar.</P>
 
47
<P><BR><BR>
 
48
</P>
 
49
<P><U>Search location</U></P>
 
50
<P STYLE="margin-left: 0.79in">One of several locations can be chosen
 
51
as the source to use in the search.</P>
 
52
<P STYLE="margin-left: 0.79in"><B>Path:</B> The search will include
 
53
files located in the selected folder, enable the Recurse check box to
 
54
include the contents of all sub folders.</P>
 
55
<P STYLE="margin-left: 0.79in"><B>Comments:</B> The search will
 
56
include all files that have a keyword or comment associated to it.</P>
 
57
<P STYLE="margin-left: 1.58in">Note: Only keyword and comment
 
58
associations stored in the user's home folder are included in this
 
59
search type.</P>
 
60
<P STYLE="margin-left: 0.79in"><B>Results:</B> The search will
 
61
include all files currently listed in the results list, use this to
 
62
refine a previous search.</P>
 
63
<P><BR><BR>
 
64
</P>
 
65
<P><U>Search parameters</U></P>
 
66
<P STYLE="margin-left: 0.79in">Each search parameter can be enabled
 
67
or disabled with the check box to it's left. For a file to be a
 
68
match, all enabled parameters must be true.</P>
 
69
<P STYLE="margin-left: 0.79in"><B>File name:</B> The search will
 
70
match if the entered text appears within the file name, or if the
 
71
text exactly matches the file name, depending on the method selected
 
72
from the drop down menu. The text comparison can be made to be case
 
73
sensitive by enabling the Match case checkbox.</P>
 
74
<P STYLE="margin-left: 0.79in"><B>File size:</B> The search will
 
75
match if the file size on disk is equal to, less than, greater than,
 
76
or between the entered value, depending on the method selected from
 
77
the drop down menu. The between test is inclusive, for example a file
 
78
of size 10 will match if the size parameters are between 10 and 15.</P>
 
79
<P STYLE="margin-left: 0.79in"><B>File date:</B> The search will
 
80
match if the file modification time on disk is equal to, before,
 
81
after, or between the entered date, depending on the method selected
 
82
from the drop down menu. The between test is inclusive, for example a
 
83
file with date of 10/04/2003 will match if the date parameters are
 
84
between 10/04/2003 and 12/31/2003.</P>
 
85
<P STYLE="margin-left: 0.79in">For convenience, the button with the
 
86
down arrow displays a pop up calendar to enter the date.</P>
 
87
<P STYLE="margin-left: 0.79in"><B>Image dimensions:</B> The search
 
88
will match if the image dimensions are equal to, less than, greater
 
89
than, or between the entered values, depending on the method selected
 
90
from the drop down menu. The between test is inclusive.</P>
 
91
<P STYLE="margin-left: 0.79in">The image dimensions test is simple,
 
92
both width and height must be within the allowed values for a match.</P>
 
93
<P STYLE="margin-left: 0.79in"><B>Image content:</B> The search will
 
94
match if the image contents are similar within the percentage value,
 
95
inclusive. This uses the same test and data that is used to determine
 
96
image similarity when <A HREF="5_2_finding_duplicates.html">Finding
 
97
Duplicates</A>. The entry is for entering the path for the image to
 
98
use in this test.</P>
 
99
<P STYLE="margin-left: 0.79in"><B>Keywords:</B> The search will match
 
100
if the file's associated keywords match all, match any, or exclude
 
101
the entered keywords, depending on the method selected from the drop
 
102
down menu. Keywords can be separated with a space, comma, or tab
 
103
character.</P>
 
104
<P><BR><BR>
 
105
</P>
 
106
<P><U>Results list</U></P>
 
107
<P STYLE="margin-left: 0.79in">Files that match the parameters of the
 
108
search are shown in the list. By default they are displayed in the
 
109
order that they are found, to sort the results list by a column
 
110
activate or click the column title. Activating a column that is
 
111
already used to sort the list will toggle between increasing and
 
112
decreasing sort order.</P>
 
113
<P STYLE="margin-left: 0.79in">A <B>context menu</B> is available for
 
114
the result list by right clicking the mouse or pressing the Menu key
 
115
when a row has the focus.</P>
 
116
<P STYLE="margin-left: 0.79in"><B>Keyboard shortcuts</B> available in
 
117
the results list:</P>
 
118
<CENTER>
 
119
        <TABLE WIDTH=80% BORDER=1 BORDERCOLOR="#cccccc" CELLPADDING=2 CELLSPACING=0>
 
120
                <COL WIDTH=64*>
 
121
                <COL WIDTH=64*>
 
122
                <COL WIDTH=128*>
 
123
                <TR VALIGN=TOP>
 
124
                        <TD WIDTH=25%>
 
125
                                <P ALIGN=CENTER><B>Shortcut</B></P>
 
126
                        </TD>
 
127
                        <TD WIDTH=25%>
 
128
                                <P ALIGN=CENTER><B>Context menu name</B></P>
 
129
                        </TD>
 
130
                        <TD WIDTH=50%>
 
131
                                <P ALIGN=CENTER><B>Description</B></P>
 
132
                        </TD>
 
133
                </TR>
 
134
                <TR VALIGN=TOP>
 
135
                        <TD WIDTH=25%>
 
136
                                <P ALIGN=CENTER>Enter</P>
 
137
                        </TD>
 
138
                        <TD WIDTH=25%>
 
139
                                <P ALIGN=CENTER>View</P>
 
140
                        </TD>
 
141
                        <TD WIDTH=50%>
 
142
                                <P ALIGN=CENTER>Opens selected image in main window.</P>
 
143
                        </TD>
 
144
                </TR>
 
145
                <TR VALIGN=TOP>
 
146
                        <TD WIDTH=25%>
 
147
                                <P ALIGN=CENTER>V</P>
 
148
                        </TD>
 
149
                        <TD WIDTH=25%>
 
150
                                <P ALIGN=CENTER>View in new window</P>
 
151
                        </TD>
 
152
                        <TD WIDTH=50%>
 
153
                                <P ALIGN=CENTER>Opens selected image in a new window.</P>
 
154
                        </TD>
 
155
                </TR>
 
156
                <TR VALIGN=TOP>
 
157
                        <TD WIDTH=25%>
 
158
                                <P ALIGN=CENTER>Control + A</P>
 
159
                        </TD>
 
160
                        <TD WIDTH=25%>
 
161
                                <P ALIGN=CENTER>Select all</P>
 
162
                        </TD>
 
163
                        <TD WIDTH=50%>
 
164
                                <P ALIGN=CENTER>Selects all images.</P>
 
165
                        </TD>
 
166
                </TR>
 
167
                <TR VALIGN=TOP>
 
168
                        <TD WIDTH=25%>
 
169
                                <P ALIGN=CENTER>Control + Shift + A</P>
 
170
                        </TD>
 
171
                        <TD WIDTH=25%>
 
172
                                <P ALIGN=CENTER>Select none</P>
 
173
                        </TD>
 
174
                        <TD WIDTH=50%>
 
175
                                <P ALIGN=CENTER>Clear the image selection.</P>
 
176
                        </TD>
 
177
                </TR>
 
178
                <TR VALIGN=TOP>
 
179
                        <TD WIDTH=25%>
 
180
                                <P ALIGN=CENTER>Control + 1 through<BR>Control + 0</P>
 
181
                        </TD>
 
182
                        <TD WIDTH=25%>
 
183
                                <P ALIGN=CENTER>Edit sub menu</P>
 
184
                        </TD>
 
185
                        <TD WIDTH=50%>
 
186
                                <P ALIGN=CENTER>Executes the respective editor command.</P>
 
187
                        </TD>
 
188
                </TR>
 
189
                <TR VALIGN=TOP>
 
190
                        <TD WIDTH=25%>
 
191
                                <P ALIGN=CENTER>Control + P</P>
 
192
                        </TD>
 
193
                        <TD WIDTH=25%>
 
194
                                <P ALIGN=CENTER>Properties</P>
 
195
                        </TD>
 
196
                        <TD WIDTH=50%>
 
197
                                <P ALIGN=CENTER>Opens a properties window for selected images.</P>
 
198
                        </TD>
 
199
                </TR>
 
200
                <TR VALIGN=TOP>
 
201
                        <TD WIDTH=25%>
 
202
                                <P ALIGN=CENTER>C</P>
 
203
                        </TD>
 
204
                        <TD WIDTH=25%>
 
205
                                <P ALIGN=CENTER>Add to new collection</P>
 
206
                        </TD>
 
207
                        <TD WIDTH=50%>
 
208
                                <P ALIGN=CENTER>Creates a new collection containing the selected
 
209
                                images.</P>
 
210
                        </TD>
 
211
                </TR>
 
212
                <TR VALIGN=TOP>
 
213
                        <TD WIDTH=25%>
 
214
                                <P ALIGN=CENTER><BR>
 
215
                                </P>
 
216
                        </TD>
 
217
                        <TD WIDTH=25%>
 
218
                                <P ALIGN=CENTER>Print</P>
 
219
                        </TD>
 
220
                        <TD WIDTH=50%>
 
221
                                <P ALIGN=CENTER>Opens a print dialog for selected images.</P>
 
222
                        </TD>
 
223
                </TR>
 
224
                <TR VALIGN=TOP>
 
225
                        <TD WIDTH=25%>
 
226
                                <P ALIGN=CENTER>Control + C</P>
 
227
                        </TD>
 
228
                        <TD WIDTH=25%>
 
229
                                <P ALIGN=CENTER>Copy</P>
 
230
                        </TD>
 
231
                        <TD WIDTH=50%>
 
232
                                <P ALIGN=CENTER>Copy selected images.</P>
 
233
                        </TD>
 
234
                </TR>
 
235
                <TR VALIGN=TOP>
 
236
                        <TD WIDTH=25%>
 
237
                                <P ALIGN=CENTER>Control + M</P>
 
238
                        </TD>
 
239
                        <TD WIDTH=25%>
 
240
                                <P ALIGN=CENTER>Move</P>
 
241
                        </TD>
 
242
                        <TD WIDTH=50%>
 
243
                                <P ALIGN=CENTER>Move selected images.</P>
 
244
                        </TD>
 
245
                </TR>
 
246
                <TR VALIGN=TOP>
 
247
                        <TD WIDTH=25%>
 
248
                                <P ALIGN=CENTER>Control + R</P>
 
249
                        </TD>
 
250
                        <TD WIDTH=25%>
 
251
                                <P ALIGN=CENTER>Rename</P>
 
252
                        </TD>
 
253
                        <TD WIDTH=50%>
 
254
                                <P ALIGN=CENTER>Rename selected images.</P>
 
255
                        </TD>
 
256
                </TR>
 
257
                <TR VALIGN=TOP>
 
258
                        <TD WIDTH=25%>
 
259
                                <P ALIGN=CENTER>Control + D</P>
 
260
                        </TD>
 
261
                        <TD WIDTH=25%>
 
262
                                <P ALIGN=CENTER>Delete</P>
 
263
                        </TD>
 
264
                        <TD WIDTH=50%>
 
265
                                <P ALIGN=CENTER>Delete selected images.</P>
 
266
                        </TD>
 
267
                </TR>
 
268
                <TR VALIGN=TOP>
 
269
                        <TD WIDTH=25%>
 
270
                                <P ALIGN=CENTER>Delete</P>
 
271
                        </TD>
 
272
                        <TD WIDTH=25%>
 
273
                                <P ALIGN=CENTER>Remove</P>
 
274
                        </TD>
 
275
                        <TD WIDTH=50%>
 
276
                                <P ALIGN=CENTER>Remove selected images from result list.</P>
 
277
                        </TD>
 
278
                </TR>
 
279
                <TR VALIGN=TOP>
 
280
                        <TD WIDTH=25%>
 
281
                                <P ALIGN=CENTER>Control + Delete</P>
 
282
                        </TD>
 
283
                        <TD WIDTH=25%>
 
284
                                <P ALIGN=CENTER>Clear</P>
 
285
                        </TD>
 
286
                        <TD WIDTH=50%>
 
287
                                <P ALIGN=CENTER>Cleared the result list.</P>
 
288
                        </TD>
 
289
                </TR>
 
290
                <TR VALIGN=TOP>
 
291
                        <TD WIDTH=25%>
 
292
                                <P ALIGN=CENTER>Menu</P>
 
293
                        </TD>
 
294
                        <TD WIDTH=25%>
 
295
                                <P ALIGN=CENTER><BR>
 
296
                                </P>
 
297
                        </TD>
 
298
                        <TD WIDTH=50%>
 
299
                                <P ALIGN=CENTER>Displays the context menu.</P>
 
300
                        </TD>
 
301
                </TR>
 
302
                <TR VALIGN=TOP>
 
303
                        <TD WIDTH=25%>
 
304
                                <P ALIGN=CENTER>Control + T</P>
 
305
                        </TD>
 
306
                        <TD WIDTH=25%>
 
307
                                <P ALIGN=CENTER><BR>
 
308
                                </P>
 
309
                        </TD>
 
310
                        <TD WIDTH=50%>
 
311
                                <P ALIGN=CENTER>Toggle display of thumbnails.</P>
 
312
                        </TD>
 
313
                </TR>
 
314
                <TR VALIGN=TOP>
 
315
                        <TD WIDTH=25%>
 
316
                                <P ALIGN=CENTER>Control + W</P>
 
317
                        </TD>
 
318
                        <TD WIDTH=25%>
 
319
                                <P ALIGN=CENTER><BR>
 
320
                                </P>
 
321
                        </TD>
 
322
                        <TD WIDTH=50%>
 
323
                                <P ALIGN=CENTER>Close window.</P>
 
324
                        </TD>
 
325
                </TR>
 
326
        </TABLE>
 
327
</CENTER>
 
328
<P><BR><BR>
 
329
</P>
 
330
<P STYLE="margin-left: 0.79in">The <B>selection</B> can be changed
 
331
using the keyboard and mouse the same as in a <A HREF="2_4_file_pane.html">file
 
332
pane</A> of the main window.</P>
 
333
<P STYLE="margin-left: 0.79in">The image Dimensions column of the
 
334
result list will only contain dimension information when dimensions
 
335
are included in the search parameters.</P>
 
336
<P><BR><BR>
 
337
</P>
 
338
<P><U>Status bar</U></P>
 
339
<P STYLE="margin-left: 0.79in">At the bottom of the search window is
 
340
an area that includes the following items from left to right:</P>
 
341
<P STYLE="margin-left: 0.79in"><B>Thumbnails:</B> Enable this check
 
342
box to display a thumbnail next to each image in the results list.</P>
 
343
<P STYLE="margin-left: 0.79in"><B>File count display:</B> Displays
 
344
the total count of files in the results list, and their size on disk.
 
345
The count of selected files will appear in parenthesis.</P>
 
346
<P STYLE="margin-left: 0.79in"><B>Search progress:</B> When a search
 
347
is active, the text &ldquo;Searching...&rdquo; will appear here. Two
 
348
numbers in parenthesis will also be displayed, the first number is
 
349
the number of files that match the search parameters and the second
 
350
number is the total number of files that were searched.</P>
 
351
<P STYLE="margin-left: 0.79in"><B>Find:</B> Activate the find button
 
352
to start a search with the selected parameters.</P>
 
353
<P STYLE="margin-left: 0.79in"><B>Stop:</B> Activate the stop button
 
354
to end a search that is in progress.</P>
 
355
<P><BR><BR>
 
356
</P>
 
357
<P><U>Drag and Drop</U></P>
 
358
<P STYLE="margin-left: 0.79in">Drag and drop can be initiated with
 
359
the primary or middle mouse buttons. Dragging a file that is selected
 
360
will include all selected files in the drag. Dragging a file that is
 
361
not selected will first change the selection to the dragged file, and
 
362
clear the previous selection.</P>
 
363
<P><BR><BR>
 
364
</P>
 
365
<P><BR><BR>
 
366
</P>
 
367
<HR>
 
368
<CENTER>
 
369
        <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
 
370
                <COL WIDTH=85*>
 
371
                <COL WIDTH=85*>
 
372
                <COL WIDTH=85*>
 
373
                <THEAD>
 
374
                        <TR VALIGN=TOP>
 
375
                                <TD WIDTH=33%>
 
376
                                        <P><A HREF="5_image_search.html">Previous</A></P>
 
377
                                </TD>
 
378
                                <TD WIDTH=33%>
 
379
                                        <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
 
380
                                </TD>
 
381
                                <TD WIDTH=33%>
 
382
                                        <P ALIGN=RIGHT><A HREF="5_2_finding_duplicates.html">Next</A></P>
 
383
                                </TD>
 
384
                        </TR>
 
385
                </THEAD>
 
386
                <TBODY>
 
387
                        <TR VALIGN=TOP>
 
388
                                <TD WIDTH=33%>
 
389
                                        <P><BR>
 
390
                                        </P>
 
391
                                </TD>
 
392
                                <TD WIDTH=33%>
 
393
                                        <P ALIGN=CENTER><BR>
 
394
                                        </P>
 
395
                                </TD>
 
396
                                <TD WIDTH=33%>
 
397
                                        <P ALIGN=RIGHT>GQview User Manual</P>
 
398
                                </TD>
 
399
                        </TR>
 
400
                </TBODY>
 
401
        </TABLE>
 
402
</CENTER>
 
403
<P STYLE="margin-bottom: 0in"><BR>
 
404
</P>
 
405
</BODY>
 
406
</HTML>
 
 
b'\\ No newline at end of file'