annotate doc/11_3_thumbnails.html @ 111:3a69a7a3f461

Wed Nov 15 02:05:27 2006 John Ellis <johne@verizon.net> * view_file_icon.c: Fix odd crash when removing files, it seems the high priority idle sync is no longer called before the treeview tries to redraw itself, so fix the cleanup of removed pointers so that they are always valid or NULL (I wonder if the priorities used by GtkTreeView have changed in newer versions of GTK?). * view_file_list.c: Fix progress bar warning when files are removed before thumbnail generation is finished.
author gqview
date Wed, 15 Nov 2006 07:19:16 +0000
parents e0d0593d519e
children 1b01410e6860
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
8
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
2 <HTML>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
3 <HEAD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
4 <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
5 <TITLE>Thumbnails - GQview User Manual</TITLE>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
6 <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.3 (Linux)">
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
7 <META NAME="CREATED" CONTENT="20040805;23590500">
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
8 <META NAME="CHANGED" CONTENT="20050131;9432500">
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
9 </HEAD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
10 <BODY LANG="en-US" DIR="LTR">
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
11 <CENTER>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
12 <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0 STYLE="page-break-before: always">
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
13 <COL WIDTH=85*>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
14 <COL WIDTH=85*>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
15 <COL WIDTH=85*>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
16 <THEAD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
17 <TR VALIGN=TOP>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
18 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
19 <P><A HREF="11_2_keyboard_shortcuts.html">Previous</A></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
20 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
21 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
22 <P ALIGN=CENTER>Thumbnails - Reference</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
23 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
24 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
25 <P ALIGN=RIGHT><A HREF="11_4_management.html">Next</A></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
26 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
27 </TR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
28 </THEAD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
29 </TABLE>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
30 </CENTER>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
31 <HR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
32 <H1>11.3 Thumbnails</H1>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
33 <P STYLE="text-decoration: none"><I>Note: This page only refers the
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
34 GQview thumbnail caching mechanism, the shared thumbnail cache
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
35 mechanism is not explained here.</I></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
36 <P><U>Format</U></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
37 <P STYLE="margin-left: 0.79in">Thumbnails are stored in PNG image
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
38 format. The thumbnail name is the name of the source image with
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
39 &ldquo;.png&rdquo; appended.</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
40 <P STYLE="margin-left: 0.79in">The modification time (mtime) of the
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
41 thumbnail is set to match the source file. Thumbnails are regenerated
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
42 when the timestamps of the thumbnail and source file do not match.</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
43 <P STYLE="margin-left: 0.79in"><BR><BR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
44 </P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
45 <P><U>Location</U></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
46 <P STYLE="margin-left: 0.79in">Thumbnails are stored in:</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
47 <P STYLE="margin-left: 1.58in">($HOME)/.gqview/thumbnails</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
48 <P STYLE="margin-left: 0.79in">The directory structure of the
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
49 thumbnail cache duplicates the location of the source files, for
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
50 example a source file with the name:</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
51 <P STYLE="margin-left: 1.58in">/path/to/image.jpg</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
52 <P STYLE="margin-left: 0.79in">will store the thumbnail in:</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
53 <P STYLE="margin-left: 1.58in">($HOME)/.gqview/thumbnails/path/to/image.jpg.png</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
54 <P STYLE="margin-left: 0.79in">When thumbnails are to be stored local
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
55 to the source file, the thumbnail will be placed in:</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
56 <P STYLE="margin-left: 1.58in">/path/to/.thumbnails/image.jpg.png</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
57 <P STYLE="margin-left: 0.79in">Local thumbnail caching is enabled
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
58 with the option &ldquo;Cache thumbnails into .thumbnails&rdquo; on
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
59 the <A HREF="10_1_general.html">General</A> tab of the options
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
60 dialog. If it is not possible to store the thumbnail local to the
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
61 source file (usually due to no write permissions), GQview will fall
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
62 back to saving the thumbnail in the user's ($HOME)/.gqview/thumbnails
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
63 folder.</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
64 <P><BR><BR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
65 </P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
66 <P><U>Size</U></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
67 <P STYLE="margin-left: 0.79in">GQview allows the following sizes for
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
68 thumbnails:</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
69 <P STYLE="margin-left: 1.58in">24x24, 32x32, 48x48, 64x64, 96x72,
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
70 96x96, 129x96, 128x128, 160x120, 160x160, 192x144, 192x192, 256x192,
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
71 256x256</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
72 <P STYLE="margin-left: 0.79in">The thumbnail is scaled to fit within
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
73 the preferred size maintaining the aspect ratio. Thumbnails are not
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
74 cached for images that are equal to or smaller than the preferred
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
75 thumbnail size.</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
76 <P STYLE="margin-left: 0.79in">When a cached thumbnail's width and
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
77 height do not match the preferred size, the thumbnail is regenerated.</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
78 <P><BR><BR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
79 </P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
80 <P><BR><BR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
81 </P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
82 <P><BR><BR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
83 </P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
84 <HR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
85 <CENTER>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
86 <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
87 <COL WIDTH=85*>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
88 <COL WIDTH=85*>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
89 <COL WIDTH=85*>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
90 <THEAD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
91 <TR VALIGN=TOP>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
92 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
93 <P><A HREF="11_2_keyboard_shortcuts.html">Previous</A></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
94 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
95 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
96 <P ALIGN=CENTER><A HREF="index.html">Contents</A></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
97 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
98 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
99 <P ALIGN=RIGHT><A HREF="11_4_management.html">Next</A></P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
100 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
101 </TR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
102 </THEAD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
103 <TBODY>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
104 <TR VALIGN=TOP>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
105 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
106 <P><BR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
107 </P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
108 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
109 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
110 <P ALIGN=CENTER><BR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
111 </P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
112 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
113 <TD WIDTH=33%>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
114 <P ALIGN=RIGHT>GQview User Manual</P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
115 </TD>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
116 </TR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
117 </TBODY>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
118 </TABLE>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
119 </CENTER>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
120 <P STYLE="margin-bottom: 0in"><BR>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
121 </P>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
122 </BODY>
e0d0593d519e Sync to GQview 1.5.9 release.
gqview
parents:
diff changeset
123 </HTML>