annotate doc/docbook/GuideReferenceThumbnails.xml @ 1811:f405ec9b696b default tip

Some small logic mistakes Use boolean operators for booleans and bitwise otherwise only.
author mow
date Mon, 10 May 2010 11:33:13 +0000
parents 2ae81598b254
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1773
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
1 <?xml version="1.0" encoding="utf-8"?>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
2 <section id="GuideReferenceThumbnails">
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
3 <title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
4 Thumbnails
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
5 </title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
6 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
7 Note: This page only refers the Geeqie thumbnail caching mechanism, the shared thumbnail cache mechanism is not explained here.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
8 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
9 <para/><section id="Format"><title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
10 Format
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
11 </title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
12 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
13 Thumbnails are stored in PNG image format. The thumbnail name is the name of the source image with “.png” appended.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
14 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
15 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
16 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.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
17 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
18 <para/></section><section id="Location"><title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
19 Location
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
20 </title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
21 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
22 Thumbnails are stored in:
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
23 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
24 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
25 <literal>($HOME)/.geeqie/thumbnails</literal>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
26 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
27 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
28 The directory structure of the thumbnail cache duplicates the location of the source files, for example a source file with the name:
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
29 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
30 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
31 <literal>/path/to/image.jpg</literal>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
32 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
33 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
34 will store the thumbnail in:
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
35 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
36 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
37 <literal>($HOME)/.geeqie/thumbnails/path/to/image.jpg.png</literal>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
38 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
39 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
40 When thumbnails are to be stored local to the source file, the thumbnail will be placed in:
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
41 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
42 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
43 <literal>/path/to/.thumbnails/image.jpg.png</literal>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
44 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
45 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
46 Local thumbnail caching is enabled with the option “Cache thumbnails into .thumbnails” on the <link linkend="GuideOptionsGeneral">General</link> 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.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
47 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
48 <para/></section><section id="Size"><title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
49 Size
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
50 </title>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
51 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
52 Geeqie allows the following sizes for thumbnails:
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
53 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
54 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
55 24x24, 32x32, 48x48, 64x64, 96x72, 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192, 256x256
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
56 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
57 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
58 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.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
59 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
60 <para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
61 When a cached thumbnail's width and height do not match the preferred size, the thumbnail is regenerated.
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
62 </para>
2ae81598b254 scripts for converting wiki documentation to docbook
nadvornik
parents:
diff changeset
63 <para/></section></section>