doc/image_search_search.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>Search Window - Geeqie User Manual</title>
   8 <style type="text/css">
   9 /*<![CDATA[*/
  10  p.gq-search-8 {margin-bottom: 0in}
  11  p.gq-search-7 {font-weight: bold; text-align: center}
  12  p.gq-search-6 {margin-left: 1.58in}
  13  p.gq-search-5 {margin-left: 0.79in}
  14  div.gq-search-4 {text-align: center}
  15  table.gq-search-3 {page-break-before: always}
  16  p.gq-search-2 {text-align: right}
  17  p.gq-search-1 {text-align: center}
  18 /*]]>*/
  19 </style>
  20 </head>
  21
  22 <body lang="en-US" dir="ltr">
  23   <div class="gq-search-4">
  24     <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-search-3">
  25       <col width="85*" />
  26       <col width="85*" />
  27       <col width="85*" />
  28
  29       <thead>
  30         <tr valign="top">
  31           <td width="33%">
  32             <p><a href="image_search.html">Previous</a>
  33             </p>
  34           </td>
  35
  36           <td width="33%">
  37             <p class="gq-search-1">Search Window &ndash; Image Search</p>
  38           </td>
  39
  40           <td width="33%">
  41             <p class="gq-search-2"><a href="image_search_finding_duplicates.html">Next</a>
  42             </p>
  43           </td>
  44         </tr>
  45       </thead>
  46     </table>
  47   </div>
  48
  49   <hr />
  50
  51   <h1>Search Window</h1>
  52
  53   <p>Geeqie provides a utility to find one or more images based on various parameters.</p>
  54
  55   <p>To display a new Search Window press F3 or select Search from the File menu.</p>
  56
  57   <p><br />
  58   <br />
  59   </p>
  60
  61   <p>To start a search activate the Find button. A search in progress can be stopped by activating the Stop button.</p>
  62
  63   <p>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>
  64
  65   <p>When a search is completed, the total number of files found and their total size will be displayed in the status bar.</p>
  66
  67   <p><br />
  68   <br />
  69   </p>
  70
  71   <p><u>Search location</u>
  72   </p>
  73
  74   <p class="gq-search-5">One of several locations can be chosen as the source to use in the search.</p>
  75
  76   <p class="gq-search-5"><b>Path:</b> The search will include files located in the selected folder, enable the Recurse check box to include the contents of all sub folders.</p>
  77
  78   <p class="gq-search-5"><b>Comments:</b> The search will include all files that have a keyword or comment associated to it.</p>
  79
  80   <p class="gq-search-6">Note: Only keyword and comment associations stored in the user's home folder are included in this search type.</p>
  81
  82   <p class="gq-search-5"><b>Results:</b> The search will include all files currently listed in the results list, use this to refine a previous search.</p>
  83
  84   <p><br />
  85   <br />
  86   </p>
  87
  88   <p><u>Search parameters</u>
  89   </p>
  90
  91   <p class="gq-search-5">Each search parameter can be enabled or disabled with the check box to it's left. For a file to be a match, all enabled parameters must be true.</p>
  92
  93   <p class="gq-search-5"><b>File name:</b> 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.</p>
  94
  95   <p class="gq-search-5"><b>File size:</b> 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 between test is inclusive, for example a file of size 10 will match if the size parameters are between 10 and 15.</p>
  96
  97   <p class="gq-search-5"><b>File date:</b> 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 between 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.</p>
  98
  99   <p class="gq-search-5">For convenience, the button with the down arrow displays a pop up calendar to enter the date.</p>
 100
 101   <p class="gq-search-5"><b>Image dimensions:</b> 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 between test is inclusive.</p>
 102
 103   <p class="gq-search-5">The image dimensions test is simple, both width and height must be within the allowed values for a match.</p>
 104
 105   <p class="gq-search-5"><b>Image content:</b> 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 <a href="image_search_finding_duplicates.html">Finding Duplicates</a>. The entry is for entering the path for the image to use in this test.</p>
 106
 107   <p class="gq-search-5"><b>Keywords:</b> 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.</p>
 108
 109   <p><br />
 110   <br />
 111   </p>
 112
 113   <p><u>Results list</u>
 114   </p>
 115
 116   <p class="gq-search-5">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>
 117
 118   <p class="gq-search-5">A <b>context menu</b> is available for the result list by right clicking the mouse or pressing the Menu key when a row has the focus.</p>
 119
 120   <p class="gq-search-5"><b>Keyboard shortcuts</b> available in the results list:</p>
 121
 122   <div class="gq-search-4">
 123     <table width="80%" border="1" cellpadding="2" cellspacing="0">
 124       <col width="64*" />
 125       <col width="64*" />
 126       <col width="128*" />
 127
 128       <tr valign="top">
 129         <td width="25%">
 130           <p class="gq-search-7">Shortcut</p>
 131         </td>
 132
 133         <td width="25%">
 134           <p class="gq-search-7">Context menu name</p>
 135         </td>
 136
 137         <td width="50%">
 138           <p class="gq-search-7">Description</p>
 139         </td>
 140       </tr>
 141
 142       <tr valign="top">
 143         <td width="25%">
 144           <p class="gq-search-1">Enter</p>
 145         </td>
 146
 147         <td width="25%">
 148           <p class="gq-search-1">View</p>
 149         </td>
 150
 151         <td width="50%">
 152           <p class="gq-search-1">Opens selected image in main window.</p>
 153         </td>
 154       </tr>
 155
 156       <tr valign="top">
 157         <td width="25%">
 158           <p class="gq-search-1">V</p>
 159         </td>
 160
 161         <td width="25%">
 162           <p class="gq-search-1">View in new window</p>
 163         </td>
 164
 165         <td width="50%">
 166           <p class="gq-search-1">Opens selected image in a new window.</p>
 167         </td>
 168       </tr>
 169
 170       <tr valign="top">
 171         <td width="25%">
 172           <p class="gq-search-1">Control + A</p>
 173         </td>
 174
 175         <td width="25%">
 176           <p class="gq-search-1">Select all</p>
 177         </td>
 178
 179         <td width="50%">
 180           <p class="gq-search-1">Selects all images.</p>
 181         </td>
 182       </tr>
 183
 184       <tr valign="top">
 185         <td width="25%">
 186           <p class="gq-search-1">Control + Shift + A</p>
 187         </td>
 188
 189         <td width="25%">
 190           <p class="gq-search-1">Select none</p>
 191         </td>
 192
 193         <td width="50%">
 194           <p class="gq-search-1">Clear the image selection.</p>
 195         </td>
 196       </tr>
 197
 198       <tr valign="top">
 199         <td width="25%">
 200           <p class="gq-search-1">Control + 1 through<br />
 201           Control + 0</p>
 202         </td>
 203
 204         <td width="25%">
 205           <p class="gq-search-1">Edit sub menu</p>
 206         </td>
 207
 208         <td width="50%">
 209           <p class="gq-search-1">Executes the respective editor command.</p>
 210         </td>
 211       </tr>
 212
 213       <tr valign="top">
 214         <td width="25%">
 215           <p class="gq-search-1">Control + P</p>
 216         </td>
 217
 218         <td width="25%">
 219           <p class="gq-search-1">Properties</p>
 220         </td>
 221
 222         <td width="50%">
 223           <p class="gq-search-1">Opens a properties window for selected images.</p>
 224         </td>
 225       </tr>
 226
 227       <tr valign="top">
 228         <td width="25%">
 229           <p class="gq-search-1">C</p>
 230         </td>
 231
 232         <td width="25%">
 233           <p class="gq-search-1">Add to new collection</p>
 234         </td>
 235
 236         <td width="50%">
 237           <p class="gq-search-1">Creates a new collection containing the selected images.</p>
 238         </td>
 239       </tr>
 240
 241       <tr valign="top">
 242         <td width="25%">
 243           <p class="gq-search-1"><br />
 244           </p>
 245         </td>
 246
 247         <td width="25%">
 248           <p class="gq-search-1">Print</p>
 249         </td>
 250
 251         <td width="50%">
 252           <p class="gq-search-1">Opens a print dialog for selected images.</p>
 253         </td>
 254       </tr>
 255
 256       <tr valign="top">
 257         <td width="25%">
 258           <p class="gq-search-1">Control + C</p>
 259         </td>
 260
 261         <td width="25%">
 262           <p class="gq-search-1">Copy</p>
 263         </td>
 264
 265         <td width="50%">
 266           <p class="gq-search-1">Copy selected images.</p>
 267         </td>
 268       </tr>
 269
 270       <tr valign="top">
 271         <td width="25%">
 272           <p class="gq-search-1">Control + M</p>
 273         </td>
 274
 275         <td width="25%">
 276           <p class="gq-search-1">Move</p>
 277         </td>
 278
 279         <td width="50%">
 280           <p class="gq-search-1">Move selected images.</p>
 281         </td>
 282       </tr>
 283
 284       <tr valign="top">
 285         <td width="25%">
 286           <p class="gq-search-1">Control + R</p>
 287         </td>
 288
 289         <td width="25%">
 290           <p class="gq-search-1">Rename</p>
 291         </td>
 292
 293         <td width="50%">
 294           <p class="gq-search-1">Rename selected images.</p>
 295         </td>
 296       </tr>
 297
 298       <tr valign="top">
 299         <td width="25%">
 300           <p class="gq-search-1">Control + D</p>
 301         </td>
 302
 303         <td width="25%">
 304           <p class="gq-search-1">Delete</p>
 305         </td>
 306
 307         <td width="50%">
 308           <p class="gq-search-1">Delete selected images.</p>
 309         </td>
 310       </tr>
 311
 312       <tr valign="top">
 313         <td width="25%">
 314           <p class="gq-search-1">Delete</p>
 315         </td>
 316
 317         <td width="25%">
 318           <p class="gq-search-1">Remove</p>
 319         </td>
 320
 321         <td width="50%">
 322           <p class="gq-search-1">Remove selected images from result list.</p>
 323         </td>
 324       </tr>
 325
 326       <tr valign="top">
 327         <td width="25%">
 328           <p class="gq-search-1">Control + Delete</p>
 329         </td>
 330
 331         <td width="25%">
 332           <p class="gq-search-1">Clear</p>
 333         </td>
 334
 335         <td width="50%">
 336           <p class="gq-search-1">Cleared the result list.</p>
 337         </td>
 338       </tr>
 339
 340       <tr valign="top">
 341         <td width="25%">
 342           <p class="gq-search-1">Menu</p>
 343         </td>
 344
 345         <td width="25%">
 346           <p class="gq-search-1"><br />
 347           </p>
 348         </td>
 349
 350         <td width="50%">
 351           <p class="gq-search-1">Displays the context menu.</p>
 352         </td>
 353       </tr>
 354
 355       <tr valign="top">
 356         <td width="25%">
 357           <p class="gq-search-1">Control + T</p>
 358         </td>
 359
 360         <td width="25%">
 361           <p class="gq-search-1"><br />
 362           </p>
 363         </td>
 364
 365         <td width="50%">
 366           <p class="gq-search-1">Toggle display of thumbnails.</p>
 367         </td>
 368       </tr>
 369
 370       <tr valign="top">
 371         <td width="25%">
 372           <p class="gq-search-1">Control + W</p>
 373         </td>
 374
 375         <td width="25%">
 376           <p class="gq-search-1"><br />
 377           </p>
 378         </td>
 379
 380         <td width="50%">
 381           <p class="gq-search-1">Close window.</p>
 382         </td>
 383       </tr>
 384     </table>
 385   </div>
 386
 387   <p><br />
 388   <br />
 389   </p>
 390
 391   <p class="gq-search-5">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>
 392
 393   <p class="gq-search-5">The image Dimensions column of the result list will only contain dimension information when dimensions are included in the search parameters.</p>
 394
 395   <p><br />
 396   <br />
 397   </p>
 398
 399   <p><u>Status bar</u>
 400   </p>
 401
 402   <p class="gq-search-5">At the bottom of the search window is an area that includes the following items from left to right:</p>
 403
 404   <p class="gq-search-5"><b>Thumbnails:</b> Enable this check box to display a thumbnail next to each image in the results list.</p>
 405
 406   <p class="gq-search-5"><b>File count display:</b> Displays the total count of files in the results list, and their size on disk. The count of selected files will appear in parenthesis.</p>
 407
 408   <p class="gq-search-5"><b>Search progress:</b> When a search is active, the text &#8220;Searching...&#8221; 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.</p>
 409
 410   <p class="gq-search-5"><b>Find:</b> Activate the find button to start a search with the selected parameters.</p>
 411
 412   <p class="gq-search-5"><b>Stop:</b> Activate the stop button to end a search that is in progress.</p>
 413
 414   <p><br />
 415   <br />
 416   </p>
 417
 418   <p><u>Drag and Drop</u>
 419   </p>
 420
 421   <p class="gq-search-5">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>
 422
 423   <p><br />
 424   <br />
 425   </p>
 426
 427   <p><br />
 428   <br />
 429   </p>
 430
 431   <hr />
 432
 433   <div class="gq-search-4">
 434     <table width="100%" border="0" cellpadding="4" cellspacing="0">
 435       <col width="85*" />
 436       <col width="85*" />
 437       <col width="85*" />
 438
 439       <thead>
 440         <tr valign="top">
 441           <td width="33%">
 442             <p><a href="image_search.html">Previous</a>
 443             </p>
 444           </td>
 445
 446           <td width="33%">
 447             <p class="gq-search-1"><a href="index.html">Contents</a>
 448             </p>
 449           </td>
 450
 451           <td width="33%">
 452             <p class="gq-search-2"><a href="image_search_finding_duplicates.html">Next</a>
 453             </p>
 454           </td>
 455         </tr>
 456       </thead>
 457
 458       <tbody>
 459         <tr valign="top">
 460           <td width="33%">
 461             <p><br />
 462             </p>
 463           </td>
 464
 465           <td width="33%">
 466             <p class="gq-search-1"><br />
 467             </p>
 468           </td>
 469
 470           <td width="33%">
 471             <p class="gq-search-2">Geeqie User Manual</p>
 472           </td>
 473         </tr>
 474       </tbody>
 475     </table>
 476   </div>
 477
 478   <p class="gq-search-8"><br />
 479   </p>
 480 </body>
 481 </html>