doc/docbook/GuideReferenceThumbnails.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <section id="GuideReferenceThumbnails">\r
   3   <title>Thumbnails</title>\r
   4   <note>\r
   5     <para>\r
   6       This page only refers the Geeqie thumbnail caching mechanism, the shared thumbnail cache mechanism is described in\r
   7       <link linkend="GuideReferenceStandards">Thumbnail Standards</link>\r
   8       .\r
   9     </para>\r
  10   </note>\r
  11   <para />\r
  12   <section id="Format">\r
  13     <title>Format</title>\r
  14     <para>Thumbnails are stored in PNG image format. The thumbnail name is the name of the source image with “.png” appended.</para>\r
  15     <para>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.</para>\r
  16     <para />\r
  17   </section>\r
  18   <section id="Location">\r
  19     <title>Location</title>\r
  20     <para>\r
  21       Thumbnails are stored in a location specified in\r
  22       <link linkend="PreferencesThumbnails">Thumbnail Preferences</link>\r
  23       .\r
  24 \r
  25     </para>\r
  26     <para>The directory structure of the thumbnail cache duplicates that of the location of the source files.</para>\r
  27   </section>\r
  28   <section id="Size">\r
  29     <title>Size</title>\r
  30     <para>Geeqie allows the following sizes for thumbnails:</para>\r
  31     <para>24x24, 32x32, 48x48, 64x64, 96x72, 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192, 256x256, custom</para>\r
  32     <para>Custom size has a maximum of 512x512.</para>\r
  33     <para>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.</para>\r
  34     <para>When a cached thumbnail's width and height do not match the preferred size, the thumbnail is regenerated.</para>\r
  35     <para />\r
  36   </section>\r
  37 </section>\r