1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>Search Window</title>
6 <link rel="previous" href="GuideImageSearchSearch.html" title="Search Window">
7 <link rel="next" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">
8 <link rel="top" href="GuideIndex.html" title="The Geeqie User Manual">
9 <style type="text/css">
11 html { height: 100%; }
13 margin: 0px; padding: 12px;
14 background-color: #f9f9f6;
18 div, p, pre, blockquote { margin: 0; padding: 0; }
19 p img { vertical-align: middle; }
20 sub { font-size: 0.83em; }
21 sub sub { font-size: 1em; }
22 sup { font-size: 0.83em; }
23 sup sup { font-size: 1em; }
24 table { border-collapse: collapse; }
25 table.table-pgwide { width: 100%; }
26 td { vertical-align: top; }
27 td { padding: 0.2em 0.83em 0.2em 0.83em; }
28 th { padding: 0 0.83em 0 0.83em; }
30 background-color: #f9f9f6;
32 td.td-colsep { border-right: solid 1px; }
33 td.td-rowsep { border-bottom: solid 1px; }
34 thead { border-top: solid 2px; border-bottom: solid 2px; }
35 tfoot { border-top: solid 2px; border-bottom: solid 2px; }
39 background-color: #ffffff;
40 border: solid 1px #e0e0df;
45 div.division div.division { margin-top: 1.72em; }
46 div.division div.division div.division { margin-top: 1.44em; }
50 border-bottom: solid 1px #e0e0df;
52 h1, h2, h3, h4, h5, h6, h7 {
53 margin: 0; padding: 0;
56 h1.title { font-size: 1.72em; }
57 h2.title { font-size: 1.44em; }
58 h3.title { font-size: 1.2em; }
59 h4.title, h5.title, h6.title, h7.title { font-size: 1em; }
60 .block { margin-top: 1em; }
61 .block .block-first { margin-top: 0; }
63 margin-left left: 1.72em;
66 .block-indent .block-indent { margin-left: 0em; margin-right: 0em; }
67 td .block-indent { margin-left: 0em; margin-right: 0em; }
68 dd .block-indent { margin-left: 0em; margin-right: 0em; }
69 .block-verbatim { white-space: pre; }
75 div.title-formal { padding-left: 0.2em; padding-right: 0.2em; }
76 div.title-formal .label { font-weight: normal; }
79 text-decoration: none;
81 a:hover { text-decoration: underline; }
82 a:visited { color: #9f1f6f; }
83 ul, ol, dl { margin: 0; padding: 0; }
89 li.li-first { margin-top: 0; }
90 dt { margin: 1em 0 0 0; }
91 dt.dt-first { margin: 0; }
96 dl.dl-compact dt { margin-top: 0; }
97 dl.dl-compact dd { margin-top: 0; margin-bottom: 0; }
105 li.linktrail { display: inline; margin: 0; padding: 0; }
107 li.linktrail::before {
112 li.linktrail-first::before, li.linktrail-only::before { content: ''; }
116 padding: 0.5em 1em 0.5em 1em;
118 background-color: #ffffff;
119 border: solid 1px #e0e0df;
121 div.navbar-top { margin-bottom: 1em; }
122 div.navbar-bottom { margin-top: 1em; clear: both; }
123 div.navbar img { border: 0; vertical-align: -0.4em; }
124 table.navbar { width: 100%; margin: 0; border: none; }
125 table.navbar td { padding: 0; border: none; }
129 a.navbar-prev::before {
134 a.navbar-next::after {
143 padding: 0; margin: 0; width: 12em;
146 padding: 0.5em 1em 0 1em;
147 background-color: #ffffff;
148 border: solid 1px #e0e0df;
150 div.sidenav div.autotoc {
151 background-color: #ffffff;
152 border: none; padding: 0; margin: 0;
154 div.sidenav div.autotoc div.autotoc { margin-top: 0.5em; }
155 div.sidenav div.autotoc li { margin-bottom: 0.5em; }
156 div.sidenav div.autotoc div.autotoc div.autotoc {
160 div.sidenav div.autotoc div.autotoc div.autotoc li { margin-bottom: 0; }
168 padding: 0.5em 1em 0.5em 1em;
169 background-color: #f0f9ff;
170 border: solid 1px #c0c9ff;
172 div.autotoc ul { margin: 0; padding: 0; }
173 div.autotoc li { list-style-type: none; margin: 0; }
174 div.autotoc div.autotoc-title { margin-bottom: 0.5em; }
175 div.autotoc div.autotoc { border: none; padding: 0; margin-top: 0; margin-bottom: 0.5em; }
176 div.autotoc div.autotoc div.autotoc { margin-bottom: 0; }
185 padding: 0.5em 6px 0.5em 6px;
186 border: solid 1px #e0e0df;
187 background-color: #fffff0;
189 div.caution-inner, div.important-inner, div.note-inner, div.tip-inner, div.warning-inner {
191 background-position: left top;
192 background-repeat: no-repeat;
195 div.caution-inner { background-image: url("admon-caution.png"); }
196 div.important-inner { background-image: url("admon-important.png"); }
197 div.note-inner { background-image: url("admon-note.png"); }
198 div.note-bug div.note-inner { background-image: url("admon-bug.png"); }
199 div.tip-inner { background-image: url("admon-tip.png"); }
200 div.warning-inner { background-image: url("admon-warning.png"); }
203 background-image: url('watermark-blockquote-201C.png');
204 background-repeat: no-repeat;
205 background-position: top left;
213 div.attribution::before {
223 div.figure, div.informalfigure {
227 background-color: #f9f9f6;
228 border: solid 1px #e0e0df;
230 div.figure-inner, div.informalfigure-inner {
232 background-color: #ffffff;
233 border: solid 1px #e0e0df;
235 div.caption { margin-top: 0.5em; }
239 background-color: #f9f9f6;
240 border: solid 1px #e0e0df;
245 background-color: #f9f9f6;
246 border: solid 1px #e0e0df;
251 div.screen .userinput {
255 div.programlisting .userinput {
269 dl.index dt { margin-top: 0; }
270 dl.index dd { margin-top: 0; margin-bottom: 0; }
271 dl.indexdiv dt { margin-top: 0; }
272 dl.indexdiv dd { margin-top: 0; margin-bottom: 0; }
273 dl.setindex dt { margin-top: 0; }
274 dl.setindex dd { margin-top: 0; margin-bottom: 0; }
275 div.list div.title-formal span.title {
276 border-bottom: solid 1px #e0e0df;
281 div.simplelist table { margin-left: 0; border: none; }
284 border-left: solid 1px #e0e0df;
286 div.simplelist td.td-first {
293 background-color: #f9f9f6;
294 border-top: solid 2px #c0c9ff;
295 border-bottom: solid 2px #c0c9ff;
297 div.synopsis div.synopsis {
301 div.synopsis div.block { margin-top: 0.2em; }
302 div.synopsis div.block-first { margin-top: 0; }
303 div.cmdsynopsis { font-family: monospace; }
305 span.accel { text-decoration: underline; }
306 span.acronym { font-family: sans-serif; }
307 span.application { font-style: italic; }
308 span.classname, span.exceptionname, span.interfacename { font-family: monospace; }
310 font-family: monospace;
311 border: solid 1px #e0e0df;
313 padding-right: 0.2em;
315 pre span.code { border: none; padding: 0; }
317 font-family: monospace;
318 border: solid 1px #e0e0df;
320 padding-right: 0.2em;
322 pre span.command { border: none; padding: 0; }
323 span.computeroutput { font-family: monospace; }
325 span.constant { font-family: monospace; }
326 span.database { font-family: monospace; }
327 span.email { font-family: monospace; }
328 span.emphasis { font-style: italic; }
329 span.emphasis-bold { font-style: normal; font-weight: bold; }
330 span.envar { font-family: monospace; }
332 span.filename { font-family: monospace; }
333 span.firstterm { font-style: italic; }
334 span.foreignphrase { font-style: italic; }
335 span.function { font-family: monospace; }
337 dt.glossterm span.glossterm { font-style: normal; }
340 span.glossterm { font-style: italic; }
342 span.guibutton, span.guilabel, span.guimenu, span.guimenuitem, span.guisubmenu, span.interface {
350 span.lineannotation { font-style: italic; }
351 span.literal { font-family: monospace; }
352 span.markup { font-family: monospace; }
353 span.medialabel { font-style: italic; }
354 span.methodname { font-family: monospace; }
355 span.ooclass, span.ooexception, span.oointerface { font-family: monospace; }
356 span.option { font-family: monospace; }
357 span.parameter { font-family: monospace; }
358 span.paramdef span.parameter { font-style: italic; }
359 span.prompt { font-family: monospace; }
360 span.property { font-family: monospace; }
361 span.replaceable { font-style: italic; }
362 span.returnvalue { font-family: monospace; }
363 span.sgmltag { font-family: monospace; }
364 span.structfield, span.structname { font-family: monospace; }
365 span.symbol { font-family: monospace; }
366 span.systemitem { font-family: monospace; }
367 span.token { font-family: monospace; }
368 span.type { font-family: monospace; }
369 span.uri { font-family: monospace; }
370 span.userinput { font-family: monospace; }
371 span.varname { font-family: monospace; }
372 span.wordasword { font-style: italic; }
376 div.footnotes { font-style: italic; font-size: 0.8em; }
377 div.footnote { margin-top: 1.44em; }
378 span.footnote-number { display: inline; padding-right: 0.83em; }
379 span.footnote-number + p { display: inline; }
380 a.footnote { text-decoration: none; font-size: 0.8em; }
381 a.footnote-ref { text-decoration: none; }
384 margin-left: 0.2em; margin-right: 0.2em;
385 padding-left: 0.4em; padding-right: 0.4em;
386 border: solid 1px #000000;
387 -moz-border-radius: 8px;
388 background-color: #000000;
393 border-color: #333333;
394 background-color: #333333;
397 span.co a { text-decoration: none; }
398 span.co a:hover { text-decoration: none; }
400 dt.question { margin-left: 0em; }
401 dt.question div.label { float: left; }
402 dd + dt.question { margin-top: 1em; }
408 dd.answer div.label { float: left; }
412 <div class="navbar navbar-top"><table class="navbar"><tr>
413 <td class="navbar-prev"><a class="navbar-prev" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></td>
414 <td class="navbar-next"><a class="navbar-next" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a></td>
416 <div class="sidebar"><div class="sidenav"><div class="autotoc"><ul>
417 <li><a href="GuideIndex-info.html" title="About This Document">About This Document</a></li>
419 <a class="xref" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a><div class="autotoc"><ul>
420 <li><a class="xref" href="GuideIntroduction.html" title="Introduction">Introduction</a></li>
421 <li><a class="xref" href="GuideMainWindow.html" title="Main Window">Main Window</a></li>
422 <li><a class="xref" href="GuideSidebars.html" title="Sidebars">Sidebars</a></li>
423 <li><a class="xref" href="GuideOtherWindows.html" title="Stand-alone Windows">Stand-alone Windows</a></li>
425 <a class="xref" href="GuideImageSearch.html" title="Search and Select">Search and Select</a><div class="autotoc"><ul>
426 <li>Search Window</li>
427 <li><a class="xref" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a></li>
428 <li><a class="xref" href="GuideImageMarks.html" title="Marking Images">Marking Images</a></li>
431 <li><a class="xref" href="GuideImageManagementPlugins.html" title="Plugins">Plugins</a></li>
432 <li><a class="xref" href="GuideImageManagement.html" title="File Management">File Management</a></li>
433 <li><a class="xref" href="GuideColorManagement.html" title="Color Management">Color Management</a></li>
434 <li><a class="xref" href="GuideImagePresentation.html" title="Image Presentation">Image Presentation</a></li>
435 <li><a class="xref" href="GuidePrinting.html" title="Printing">Printing</a></li>
436 <li><a class="xref" href="GuideOptionsMain.html" title="Preferences">Preferences</a></li>
437 <li><a class="xref" href="GuideOptionsAdditional.html" title="Additional Preferences">Additional Preferences</a></li>
438 <li><a class="xref" href="GuideReference.html" title="Reference">Reference</a></li>
439 <li><a class="xref" href="GuideFaq.html" title="Frequently Asked Questions">Frequently Asked Questions</a></li>
440 <li><a class="xref" href="GuideLicence.html" title="Licence">Licence</a></li>
441 <li><a class="xref" href="GuideCredits.html" title="Credits">Credits</a></li>
442 <li><a class="xref" href="GuideGnuFdl.html" title="GNU Free Documentation License">GNU Free Documentation License</a></li>
445 </ul></div></div></div>
446 <div class="body body-sidebar"><div class="division section">
447 <a name="GuideImageSearchSearch"></a><div class="header"><h1 class="section title"><span class="title"><a name="titleGuideImageSearchSearch"></a>Search Window</span></h1></div>
448 <ul class="linktrail">
449 <li class="linktrail linktrail-first"><a class="linktrail" href="GuideIndex.html" title="The Geeqie User Manual">The Geeqie User Manual</a></li>
450 <li class="linktrail linktrail-last"><a class="linktrail" href="GuideImageSearch.html" title="Search and Select">Search and Select</a></li>
452 <p class="para block block-first">Geeqie provides a utility to find one or more images based on various parameters.</p>
453 <p class="para block">
454 To display a new Search Window press
455 <span class="keycap">F3</span>
457 <span class="guimenu">Search</span>
460 <p class="para block">
461 To start a search activate the
462 <span class="code" dir="ltr">
463 <span class="guibutton">
464 <span class="guiicon">
465 <span class="inlinegraphic"><img src="edit-find.png"></span>
470 button. A search in progress can be stopped by activating the
471 <span class="code" dir="ltr">
472 <span class="guibutton">
473 <span class="guiicon">
474 <span class="inlinegraphic"><img src="process-stop.png"></span>
481 <p class="para block">The progress of an active search is displayed as a progress bar at the bottom of the window. The progress bar will also display the total files that match the search parameters, and the total number of files searched.</p>
482 <p class="para block">When a search is completed, the total number of files found and their total size will be displayed in the status bar.</p>
483 <p class="para block"></p>
484 <div class="autotoc"><ul>
486 <span class="label">5.1.1. </span><a class="xref" href="GuideImageSearchSearch.html#Searchlocation" title="Search location">Search location</a>
489 <span class="label">5.1.2. </span><a class="xref" href="GuideImageSearchSearch.html#Searchparameters" title="Search parameters">Search parameters</a>
492 <span class="label">5.1.3. </span><a class="xref" href="GuideImageSearchSearch.html#Resultslist" title="Results list">Results list</a>
495 <span class="label">5.1.4. </span><a class="xref" href="GuideImageSearchSearch.html#Statusbar" title="Status bar">Status bar</a>
498 <span class="label">5.1.5. </span><a class="xref" href="GuideImageSearchSearch.html#DragandDrop" title="Drag and Drop">Drag and Drop</a>
501 <div class="division section">
502 <a name="Searchlocation"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.1. </span>Search location</span></h2></div>
503 <p class="para block block-first">One of several locations can be chosen as the source to use in the search.</p>
504 <div class="block list variablelist"><dl class="variablelist">
505 <dt class="term dt-first">
506 <span class="guilabel">Path</span>
508 <dd>The search will include files located in the selected folder, enable the Recurse check box to include the contents of all sub folders.</dd>
510 <span class="guilabel">Comments</span>
513 This option is only for use with GqView legacy metadata.
514 <p class="para block block-first"></p>
515 The search will include all files that have a keyword or comment associated to it.
516 <div class="admonition block note block-indent"><div class="note-inner">Only keyword and comment associations stored in the user's home folder are included in this search type.</div></div>
519 <span class="guilabel">Results</span>
521 <dd>The search will include all files currently listed in the results list. Use this to refine a previous search.</dd>
523 <p class="para block"></p>
524 <p class="para block"></p>
526 <div class="division section">
527 <a name="Searchparameters"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.2. </span>Search parameters</span></h2></div>
528 <p class="para block block-first">Each search parameter can be enabled or disabled with the check box to its left. For a file to be a match, all enabled parameters must be true.</p>
529 <div class="block list variablelist"><dl class="variablelist">
530 <dt class="term dt-first">
531 <span class="guilabel">File name</span>
533 <dd>The search will match if the entered text appears within the file name, or if the text exactly matches the file name, depending on the method selected from the drop down menu. The text comparison can be made to be case sensitive by enabling the Match case checkbox.</dd>
535 <span class="guilabel">File size</span>
538 The search will match if the file size on disk is equal to, less than, greater than, or between the entered value, depending on the method selected from the drop down menu. The
539 <span class="emphasis">between</span>
540 test is inclusive - for example a file of size 10 will match if the size parameters are between 10 and 15.
543 <span class="guilabel">File date</span>
546 The search will match if the file modification time on disk is equal to, before, after, or between the entered date, depending on the method selected from the drop down menu. The
547 <span class="emphasis">between</span>
548 test is inclusive, for example a file with date of 10/04/2003 will match if the date parameters are between 10/04/2003 and 12/31/2003.
549 <p class="para block"></p>
551 <span class="code" dir="ltr">
552 <span class="guibutton">
553 <span class="guiicon">
554 <span class="inlinegraphic"><img src="go-down.png"></span>
558 button displays a pop up calendar to enter the date.
559 <p class="para block"></p>
561 <span class="emphasis emphasis-bold">Exif date</span>
562 checkbox permits searches to be made on the exif date of images. If an image does not have an exif date, it will default to 01 January 1970.
565 <span class="guilabel">Image dimensions</span>
568 The search will match if the image dimensions are equal to, less than, greater than, or between the entered values, depending on the method selected from the drop down menu. The
569 <span class="emphasis">between</span>
571 <p class="para block"></p>
572 The image dimensions test is simple, both width and height must be within the allowed values for a match.
575 <span class="guilabel">Image content</span>
578 The search will match if the image contents are similar within the percentage value, inclusive. This uses the same test and data that is used to determine image similarity when
579 <a class="link" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a>
580 . The entry is for entering the path for the image to use in this test.
583 <span class="guilabel">Keywords</span>
585 <dd>The search will match if the file's associated keywords match all, match any, or exclude the entered keywords, depending on the method selected from the drop down menu. Keywords can be separated with a space, comma, or tab character.</dd>
587 <span class="guilabel">Geocoded position</span>
590 The search will match if the file's GPS position is less than or greater than the selected distance from the specified position, or is not geocoded, depending on the method selected from the drop down menu.
591 The search location can be specified by
592 <div class="block list itemizedlist"><ul class="itemizedlist">
593 <li class="li-first">
594 Type in a latitude/longitude in the format
595 <span class="code" dir="ltr">89.123 179.123</span>
597 <li>Drag-and-drop a geocoded image onto the search box</li>
598 <li>If Geeqie's map is displayed, a left-click on the map will store the latitude/longitude under the mouse cursor into the clipboard. It can then be pasted into the search box.</li>
599 <li>Copy-and-paste (in some circumstances drag-and-drop) the result of an Internet search.</li>
601 <div class="admonition block note block-indent"><div class="note-inner">
602 In this last case, the result of a search may contain the latitude/longitude embedded in the URL. This may be automatically decoded with the help of an external file:-
603 <div dir="ltr" class=" block programlisting block-indent block-first"><pre class="programlisting">~/.config/geeqie/geocode-parameters.awk</pre></div>
605 <a class="link" href="GuideReferenceDecodeLatLong.html" title="Decoding Latitude and Longitude">Decoding Latitude and Longitude</a>
606 for details on how to create this file.
610 <p class="para block"></p>
611 <p class="para block"></p>
613 <div class="division section">
614 <a name="Resultslist"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.3. </span>Results list</span></h2></div>
615 <p class="para block block-first">Files that match the parameters of the search are shown in the list. By default they are displayed in the order that they are found. To sort the results list by a column, activate or click the column title. Activating a column that is already used to sort the list will toggle between increasing and decreasing sort order.</p>
616 <p class="para block">
618 <span class="emphasis emphasis-bold">context menu</span>
619 is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus.
621 <p class="para block">
623 <a class="link" href="GuideReferenceKeyboardShortcuts.html" title="Keyboard and Mouse Shortcuts">Keyboard and Mouse Shortcuts</a>
624 available are listed here.
626 <p class="para block">The image Dimensions column of the result list will only contain dimension information when dimensions are included in the search parameters.</p>
627 <p class="para block"></p>
629 <div class="division section">
630 <a name="Statusbar"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.4. </span>Status bar</span></h2></div>
631 <p class="para block block-first">At the bottom of the search window is an area that includes the following items from left to right:</p>
632 <div class="block list variablelist">
633 <p class="para block"></p>
634 <dl class="variablelist">
635 <dt class="term dt-first">
636 <span class="guilabel">Thumbnails</span>
638 <dd>Enable this check box to display a thumbnail next to each image in the results list.</dd>
640 <span class="guilabel">File count display</span>
642 <dd>Displays the total count of files in the results list, and their size on disk. The count of selected files will appear in parenthesis.</dd>
644 <span class="guilabel">Search progress</span>
646 <dd>When a search is active, the text “Searching...” will appear here. Two numbers in parenthesis will also be displayed, the first number is the number of files that match the search parameters and the second number is the total number of files that were searched.</dd>
648 <span class="code" dir="ltr">
649 <span class="guibutton">
650 <span class="guiicon">
651 <span class="inlinegraphic"><img src="edit-find.png"></span>
657 <dd>Activate the find button to start a search with the selected parameters.</dd>
659 <span class="code" dir="ltr">
660 <span class="guibutton">
661 <span class="guiicon">
662 <span class="inlinegraphic"><img src="process-stop.png"></span>
668 <dd>Activate the stop button to end a search that is in progress.</dd>
671 <p class="para block"></p>
672 <p class="para block"></p>
674 <div class="division section">
675 <a name="DragandDrop"></a><div class="header"><h2 class="section title"><span class="title"><span class="label">5.1.5. </span>Drag and Drop</span></h2></div>
676 <p class="para block block-first">Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</p>
677 <p class="para block"></p>
680 <div class="navbar navbar-bottom"><table class="navbar"><tr>
681 <td class="navbar-prev"><a class="navbar-prev" href="GuideImageSearchSearch.html" title="Search Window">Search Window</a></td>
682 <td class="navbar-next"><a class="navbar-next" href="GuideImageSearchFindingDuplicates.html" title="Finding Duplicates">Finding Duplicates</a></td>