doc/11_3_thumbnails.html

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   4
   5 <html xmlns="http://www.w3.org/1999/xhtml">
   6 <head>
   7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
   8
   9   <title>Thumbnails - Geeqie User Manual</title>
  10   <meta name="CREATED" content="20040805;23590500" />
  11   <meta name="CHANGED" content="20050131;9432500" />
  12 <style type="text/css">
  13 /*<![CDATA[*/
  14  p.gq-thumbnails-8 {margin-bottom: 0in}
  15  p.gq-thumbnails-7 {margin-left: 1.58in}
  16  p.gq-thumbnails-6 {margin-left: 0.79in}
  17  p.gq-thumbnails-5 {font-style: italic; text-decoration: none}
  18  div.gq-thumbnails-4 {text-align: center}
  19  table.gq-thumbnails-3 {page-break-before: always}
  20  p.gq-thumbnails-2 {text-align: right}
  21  p.gq-thumbnails-1 {text-align: center}
  22 /*]]>*/
  23 </style>
  24 </head>
  25
  26 <body lang="en-US" dir="ltr" xml:lang="en-US">
  27   <div class="gq-thumbnails-4">
  28     <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-thumbnails-3">
  29       <col width="85*" />
  30       <col width="85*" />
  31       <col width="85*" />
  32
  33       <thead>
  34         <tr valign="top">
  35           <td width="33%">
  36             <p><a href="11_2_keyboard_shortcuts.html">Previous</a>
  37             </p>
  38           </td>
  39
  40           <td width="33%">
  41             <p class="gq-thumbnails-1">Thumbnails - Reference</p>
  42           </td>
  43
  44           <td width="33%">
  45             <p class="gq-thumbnails-2"><a href="11_4_management.html">Next</a>
  46             </p>
  47           </td>
  48         </tr>
  49       </thead>
  50     </table>
  51   </div>
  52
  53   <hr />
  54
  55   <h1>11.3 Thumbnails</h1>
  56
  57   <p class="gq-thumbnails-5">Note: This page only refers the Geeqie thumbnail caching mechanism, the shared thumbnail cache mechanism is not explained here.</p>
  58
  59   <p><u>Format</u>
  60   </p>
  61
  62   <p class="gq-thumbnails-6">Thumbnails are stored in PNG image format. The thumbnail name is the name of the source image with &ldquo;.png&rdquo; appended.</p>
  63
  64   <p class="gq-thumbnails-6">The modification time (mtime) of the thumbnail is set to match the source file. Thumbnails are regenerated when the timestamps of the thumbnail and source file do not match.</p>
  65
  66   <p class="gq-thumbnails-6"><br />
  67   <br />
  68   </p>
  69
  70   <p><u>Location</u>
  71   </p>
  72
  73   <p class="gq-thumbnails-6">Thumbnails are stored in:</p>
  74
  75   <p class="gq-thumbnails-7">($HOME)/.geeqie/thumbnails</p>
  76
  77   <p class="gq-thumbnails-6">The directory structure of the thumbnail cache duplicates the location of the source files, for example a source file with the name:</p>
  78
  79   <p class="gq-thumbnails-7">/path/to/image.jpg</p>
  80
  81   <p class="gq-thumbnails-6">will store the thumbnail in:</p>
  82
  83   <p class="gq-thumbnails-7">($HOME)/.geeqie/thumbnails/path/to/image.jpg.png</p>
  84
  85   <p class="gq-thumbnails-6">When thumbnails are to be stored local to the source file, the thumbnail will be placed in:</p>
  86
  87   <p class="gq-thumbnails-7">/path/to/.thumbnails/image.jpg.png</p>
  88
  89   <p class="gq-thumbnails-6">Local thumbnail caching is enabled with the option &ldquo;Cache thumbnails into .thumbnails&rdquo; on the <a href="10_1_general.html">General</a> tab of the options dialog. If it is not possible to store the thumbnail local to the source file (usually due to no write permissions), Geeqie will fall back to saving the thumbnail in the user's ($HOME)/.geeqie/thumbnails folder.</p>
  90
  91   <p><br />
  92   <br />
  93   </p>
  94
  95   <p><u>Size</u>
  96   </p>
  97
  98   <p class="gq-thumbnails-6">Geeqie allows the following sizes for thumbnails:</p>
  99
 100   <p class="gq-thumbnails-7">24x24, 32x32, 48x48, 64x64, 96x72, 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192, 256x256</p>
 101
 102   <p class="gq-thumbnails-6">The thumbnail is scaled to fit within the preferred size maintaining the aspect ratio. Thumbnails are not cached for images that are equal to or smaller than the preferred thumbnail size.</p>
 103
 104   <p class="gq-thumbnails-6">When a cached thumbnail's width and height do not match the preferred size, the thumbnail is regenerated.</p>
 105
 106   <p><br />
 107   <br />
 108   </p>
 109
 110   <p><br />
 111   <br />
 112   </p>
 113
 114   <p><br />
 115   <br />
 116   </p>
 117
 118   <hr />
 119
 120   <div class="gq-thumbnails-4">
 121     <table width="100%" border="0" cellpadding="4" cellspacing="0">
 122       <col width="85*" />
 123       <col width="85*" />
 124       <col width="85*" />
 125
 126       <thead>
 127         <tr valign="top">
 128           <td width="33%">
 129             <p><a href="11_2_keyboard_shortcuts.html">Previous</a>
 130             </p>
 131           </td>
 132
 133           <td width="33%">
 134             <p class="gq-thumbnails-1"><a href="index.html">Contents</a>
 135             </p>
 136           </td>
 137
 138           <td width="33%">
 139             <p class="gq-thumbnails-2"><a href="11_4_management.html">Next</a>
 140             </p>
 141           </td>
 142         </tr>
 143       </thead>
 144
 145       <tbody>
 146         <tr valign="top">
 147           <td width="33%">
 148             <p><br />
 149             </p>
 150           </td>
 151
 152           <td width="33%">
 153             <p class="gq-thumbnails-1"><br />
 154             </p>
 155           </td>
 156
 157           <td width="33%">
 158             <p class="gq-thumbnails-2">Geeqie User Manual</p>
 159           </td>
 160         </tr>
 161       </tbody>
 162     </table>
 163   </div>
 164
 165   <p class="gq-thumbnails-8"><br />
 166   </p>
 167 </body>
 168 </html>