doc/11_3_thumbnails.html

   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>Thumbnails - GQview User Manual</TITLE>
   6         <META NAME="CREATED" CONTENT="20040805;23590500">
   7         <META NAME="CHANGED" CONTENT="20050131;9432500">
   8 </HEAD>
   9 <BODY LANG="en-US" DIR="LTR">
  10 <CENTER>
  11         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
  12                 <COL WIDTH=85*>
  13                 <COL WIDTH=85*>
  14                 <COL WIDTH=85*>
  15                 <THEAD>
  16                         <TR VALIGN=TOP>
  17                                 <TD WIDTH=33%>
  18                                         <P><A HREF="11_2_keyboard_shortcuts.html">Previous</A></P>
  19                                 </TD>
  20                                 <TD WIDTH=33%>
  21                                         <P ALIGN=CENTER>Thumbnails - Reference</P>
  22                                 </TD>
  23                                 <TD WIDTH=33%>
  24                                         <P ALIGN=RIGHT><A HREF="11_4_management.html">Next</A></P>
  25                                 </TD>
  26                         </TR>
  27                 </THEAD>
  28         </TABLE>
  29 </CENTER>
  30 <HR>
  31 <H1>11.3 Thumbnails</H1>
  32 <P STYLE="text-decoration: none"><I>Note: This page only refers the
  33 GQview thumbnail caching mechanism, the shared thumbnail cache
  34 mechanism is not explained here.</I></P>
  35 <P><U>Format</U></P>
  36 <P STYLE="margin-left: 0.79in">Thumbnails are stored in PNG image
  37 format. The thumbnail name is the name of the source image with
  38 &ldquo;.png&rdquo; appended.</P>
  39 <P STYLE="margin-left: 0.79in">The modification time (mtime) of the
  40 thumbnail is set to match the source file. Thumbnails are regenerated
  41 when the timestamps of the thumbnail and source file do not match.</P>
  42 <P STYLE="margin-left: 0.79in"><BR><BR>
  43 </P>
  44 <P><U>Location</U></P>
  45 <P STYLE="margin-left: 0.79in">Thumbnails are stored in:</P>
  46 <P STYLE="margin-left: 1.58in">($HOME)/.gqview/thumbnails</P>
  47 <P STYLE="margin-left: 0.79in">The directory structure of the
  48 thumbnail cache duplicates the location of the source files, for
  49 example a source file with the name:</P>
  50 <P STYLE="margin-left: 1.58in">/path/to/image.jpg</P>
  51 <P STYLE="margin-left: 0.79in">will store the thumbnail in:</P>
  52 <P STYLE="margin-left: 1.58in">($HOME)/.gqview/thumbnails/path/to/image.jpg.png</P>
  53 <P STYLE="margin-left: 0.79in">When thumbnails are to be stored local
  54 to the source file, the thumbnail will be placed in:</P>
  55 <P STYLE="margin-left: 1.58in">/path/to/.thumbnails/image.jpg.png</P>
  56 <P STYLE="margin-left: 0.79in">Local thumbnail caching is enabled
  57 with the option &ldquo;Cache thumbnails into .thumbnails&rdquo; on
  58 the <A HREF="10_1_general.html">General</A> tab of the options
  59 dialog. If it is not possible to store the thumbnail local to the
  60 source file (usually due to no write permissions), GQview will fall
  61 back to saving the thumbnail in the user's ($HOME)/.gqview/thumbnails
  62 folder.</P>
  63 <P><BR><BR>
  64 </P>
  65 <P><U>Size</U></P>
  66 <P STYLE="margin-left: 0.79in">GQview allows the following sizes for
  67 thumbnails:</P>
  68 <P STYLE="margin-left: 1.58in">24x24, 32x32, 48x48, 64x64, 96x72,
  69 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192,
  70 256x256</P>
  71 <P STYLE="margin-left: 0.79in">The thumbnail is scaled to fit within
  72 the preferred size maintaining the aspect ratio. Thumbnails are not
  73 cached for images that are equal to or smaller than the preferred
  74 thumbnail size.</P>
  75 <P STYLE="margin-left: 0.79in">When a cached thumbnail's width and
  76 height do not match the preferred size, the thumbnail is regenerated.</P>
  77 <P><BR><BR>
  78 </P>
  79 <P><BR><BR>
  80 </P>
  81 <P><BR><BR>
  82 </P>
  83 <HR>
  84 <CENTER>
  85         <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
  86                 <COL WIDTH=85*>
  87                 <COL WIDTH=85*>
  88                 <COL WIDTH=85*>
  89                 <THEAD>
  90                         <TR VALIGN=TOP>
  91                                 <TD WIDTH=33%>
  92                                         <P><A HREF="11_2_keyboard_shortcuts.html">Previous</A></P>
  93                                 </TD>
  94                                 <TD WIDTH=33%>
  95                                         <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
  96                                 </TD>
  97                                 <TD WIDTH=33%>
  98                                         <P ALIGN=RIGHT><A HREF="11_4_management.html">Next</A></P>
  99                                 </TD>
 100                         </TR>
 101                 </THEAD>
 102                 <TBODY>
 103                         <TR VALIGN=TOP>
 104                                 <TD WIDTH=33%>
 105                                         <P><BR>
 106                                         </P>
 107                                 </TD>
 108                                 <TD WIDTH=33%>
 109                                         <P ALIGN=CENTER><BR>
 110                                         </P>
 111                                 </TD>
 112                                 <TD WIDTH=33%>
 113                                         <P ALIGN=RIGHT>GQview User Manual</P>
 114                                 </TD>
 115                         </TR>
 116                 </TBODY>
 117         </TABLE>
 118 </CENTER>
 119 <P STYLE="margin-bottom: 0in"><BR>
 120 </P>
 121 </BODY>
 122 </HTML>