annotate doc/reference_thumbnails.html @ 1615:b1c5c5e4826d

added doxygen.conf https://sourceforge.net/tracker/?func=detail&aid=2795068&group_id=222125&atid=1054680
author nadvornik
date Sat, 23 May 2009 21:23:06 +0000
parents c564ab6c11fc
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
1 <?xml version="1.0" encoding="iso-8859-1"?>
1121
24c89a03ec12 Move from xhtml transitional to xhtml strict.
zas_
parents: 1115
diff changeset
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
24c89a03ec12 Move from xhtml transitional to xhtml strict.
zas_
parents: 1115
diff changeset
3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
4
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
5 <html xmlns="http://www.w3.org/1999/xhtml">
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
6 <head>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
7 <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
8
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
9 <title>Thumbnails - Geeqie User Manual</title>
1151
c564ab6c11fc Add specific css for print media(has to be improved).
zas_
parents: 1121
diff changeset
10 <link rel="stylesheet" type="text/css" href="style.css" media="all" />
c564ab6c11fc Add specific css for print media(has to be improved).
zas_
parents: 1121
diff changeset
11 <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
c564ab6c11fc Add specific css for print media(has to be improved).
zas_
parents: 1121
diff changeset
12 <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
13 </head>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
14
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
15 <body lang="en-US" dir="ltr" xml:lang="en-US">
1097
37536ba2d5f4 Add two css classes navtop and navbottom and remove unused ones.
zas_
parents: 1095
diff changeset
16 <div class="navtop">
1099
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
17 <table width="100%" border="0" cellpadding="4" cellspacing="0">
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
18 <col id="navtop_col1" width="33%"></col>
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
19 <col id="navtop_col2" width="33%"></col>
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
20 <col id="navtop_col3" width="33%"></col>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
21
1099
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
22 <tr>
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
23 <th>
1082
47b9f5bc2606 Align Previous to the left, drop useless col tags.
zas_
parents: 1081
diff changeset
24 <p class="previous"><a href="reference_keyboard_shortcuts.html">Previous</a>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
25 </p>
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
26 </th>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
27
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
28 <th>
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
29 <p class="navtop_title">Thumbnails &ndash; Reference</p>
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
30 </th>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
31
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
32 <th>
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
33 <p class="next"><a href="reference_management.html">Next</a>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
34 </p>
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
35 </th>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
36 </tr>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
37 </table>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
38 </div>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
39
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
40 <hr />
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
41
1079
76266496b06d Drop chapters numbers from h1 title, and reformat top title a bit.
zas_
parents: 1078
diff changeset
42 <h1>Thumbnails</h1>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
43
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
44 <p>Note: This page only refers the Geeqie thumbnail caching mechanism, the shared thumbnail cache mechanism is not explained here.</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
45
1087
f00c0c5e6dff Use h2/h3 tags where appropriate.
zas_
parents: 1082
diff changeset
46 <h2>Format</h2>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
47
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
48 <p>Thumbnails are stored in PNG image format. The thumbnail name is the name of the source image with &ldquo;.png&rdquo; appended.</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
49
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
50 <p>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>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
51
1087
f00c0c5e6dff Use h2/h3 tags where appropriate.
zas_
parents: 1082
diff changeset
52 <h2>Location</h2>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
53
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
54 <p>Thumbnails are stored in:</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
55
1112
b223ad7f4867 Reformat more pages.
zas_
parents: 1105
diff changeset
56 <p><code>($HOME)/.geeqie/thumbnails</code></p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
57
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
58 <p>The directory structure of the thumbnail cache duplicates the location of the source files, for example a source file with the name:</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
59
1112
b223ad7f4867 Reformat more pages.
zas_
parents: 1105
diff changeset
60 <p><code>/path/to/image.jpg</code></p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
61
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
62 <p>will store the thumbnail in:</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
63
1112
b223ad7f4867 Reformat more pages.
zas_
parents: 1105
diff changeset
64 <p><code>($HOME)/.geeqie/thumbnails/path/to/image.jpg.png</code></p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
65
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
66 <p>When thumbnails are to be stored local to the source file, the thumbnail will be placed in:</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
67
1112
b223ad7f4867 Reformat more pages.
zas_
parents: 1105
diff changeset
68 <p><code>/path/to/.thumbnails/image.jpg.png</code></p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
69
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
70 <p>Local thumbnail caching is enabled with the option &ldquo;Cache thumbnails into .thumbnails&rdquo; on the <a href="options_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>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
71
1087
f00c0c5e6dff Use h2/h3 tags where appropriate.
zas_
parents: 1082
diff changeset
72 <h2>Size</h2>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
73
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
74 <p>Geeqie allows the following sizes for thumbnails:</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
75
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
76 <p>24x24, 32x32, 48x48, 64x64, 96x72, 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192, 256x256</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
77
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
78 <p>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>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
79
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
80 <p>When a cached thumbnail's width and height do not match the preferred size, the thumbnail is regenerated.</p>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
81
1113
79e69e5f4642 Beautify the manual.
zas_
parents: 1112
diff changeset
82 <hr id="bottomseparator" />
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
83
1097
37536ba2d5f4 Add two css classes navtop and navbottom and remove unused ones.
zas_
parents: 1095
diff changeset
84 <div class="navbottom">
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
85 <table width="100%" border="0" cellpadding="4" cellspacing="0">
1099
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
86 <col id="navbottom_col1" width="33%"></col>
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
87 <col id="navbottom_col2" width="33%"></col>
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
88 <col id="navbottom_col3" width="33%"></col>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
89
1099
b2d120fa5ee7 Use col tags with id in top and bottom navigation tables.
zas_
parents: 1098
diff changeset
90 <tr>
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
91 <th>
1082
47b9f5bc2606 Align Previous to the left, drop useless col tags.
zas_
parents: 1081
diff changeset
92 <p class="previous"><a href="reference_keyboard_shortcuts.html">Previous</a>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
93 </p>
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
94 </th>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
95
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
96 <th>
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
97 <p class="navbottom_title"><a href="index.html">Contents</a>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
98 </p>
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
99 </th>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
100
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
101 <th>
1105
215e102c1819 Drop most old css classes.
zas_
parents: 1101
diff changeset
102 <p class="next"><a href="reference_management.html">Next</a>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
103 </p>
1115
83d6b961117f Fix up unvalid xhtml.
zas_
parents: 1113
diff changeset
104 </th>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
105 </tr>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
106
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
107 </table>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
108 </div>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
109
1101
83cf0c9e300f Re-introduce Geeqie User Manual footer.
zas_
parents: 1100
diff changeset
110 <div class="footer">Geeqie User Manual</div>
1098
2d9c9b10e84d Add a generic spacer at the bottom of the page, remove now unused css classes.
zas_
parents: 1097
diff changeset
111 <div class="bottomspacer">&nbsp;</div>
1076
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
112 </body>
1ecc4f010111 With the help of tidy and sed, move html files to xhtml+css. Css classes were prefixed to ease future changes (like a common css file).
zas_
parents: 1075
diff changeset
113 </html>