1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Img Documentation</title>
<meta http-equiv="Content-Type" content="text/html" />
</head>
<body>
<h1>Img Manual</h1>
<table width="100%">
<tbody>
<tr>
<td><a href="index.htm">Introduction</a></td>
<td><a href="install.htm">Installation</a></td>
<td><a href="formats.htm">Format handlers</a></td>
<td><a href="library.htm">External libraries</a></td>
</tr>
</tbody>
</table>
<h3>Installation</h3>
<p>For Windows, just run the executable.</p>
<p>For UNIX, you have to compile the sources yourself, but that shouldn't give
you many problems. In the future, hopefully, binary distributions for various
UNIX systems will become available as well.</p>
<h3>Configure</h3>
<p>The source distributions have "configure", which has the following
possibilities:</p>
<table width="100%">
<tbody>
<tr>
<td width="10%"> </td>
<td>configure ?options?</td>
<td></td>
</tr>
<tr>
<td colspan="3">Some possible options:</td>
</tr>
<tr>
<td> </td>
<td>--prefix=<dir></td>
<td>Install headers in <dir>/include.<br />
Default: "/usr/local"</td>
</tr>
<tr>
<td> </td>
<td>--exec-prefix=<dir></td>
<td>Install libraries in <dir>/lib.<br />
Default: "${prefix}"</td>
</tr>
<tr>
<td> </td>
<td>--with-tcl=<dir></td>
<td>Find Tcl libraries in <dir> and include files in
<dir>/../include or <dir>/../generic.<br />
Default: "${exec-prefix}/lib" or a sibling directory of the Img build
directory.</td>
</tr>
<tr>
<td> </td>
<td>--with-tk=<dir></td>
<td>Find Tk libraries in <dir> and include files in
<dir>/../include or <dir>/../generic.<br />
Default: the same values as given by --with-tcl or a sibling directory
of the Img build directory.</td>
</tr>
<tr>
<td> </td>
<td>--disable-shared</td>
<td>Force the creation of static libraries.</td>
</tr>
<tr>
<td> </td>
<td>--disable-stubs</td>
<td>Disable stub support. This is necessary if you want to run Img 1.2
with Tcl/Tk 8.0 up to 8.0.5.</td>
</tr>
</tbody>
</table>
<p>Configuration of libz, libpng, libtiff, libjpeg and libttf will be done
automatically.</p>
<h3>make</h3>
<p>By default only libimg1.2.so will be built. Further on:</p>
<table width="100%">
<tbody>
<tr>
<td width="10%"> </td>
<td>make</td>
<td>build libimg1.2.so only</td>
</tr>
<tr>
<td> </td>
<td>make z</td>
<td>build libz.so.1.1.3</td>
</tr>
<tr>
<td> </td>
<td>make png</td>
<td>build libpng.so.2.1.0.7</td>
</tr>
<tr>
<td> </td>
<td>make jpeg</td>
<td>build libjpeg.so.62.0.0</td>
</tr>
<tr>
<td> </td>
<td>make tiff</td>
<td>build libtiff.so.3.5.5</td>
</tr>
<tr>
<td> </td>
<td>make all</td>
<td>build all of above</td>
</tr>
<tr>
<td> </td>
<td>make test</td>
<td>run tests for all image formats.</td>
</tr>
</tbody>
</table>
<p>Best is to start with "make". If a test fails for one of the PNG, JPEG or
TIFF formats, the error message will indicate what is wrong. If a library is
missing in your system, you can always build it later. If a crash occurs, this
might also indicate that you better upgrade one of these libraries.</p>
<p>If you prefer to use different versions numbers after the extension, you
can manually adapt the Makefile. On Irix, you can use the "ifl" libraries
which are already part of the operating system. The top of the Makefile shows
which file names to use.</p>
<h3>Install (source distributions only)</h3>
<p>You can install whatever you like:</p>
<table width="100%">
<tbody>
<tr>
<td> </td>
<td>make install</td>
<td>install libimg1.2.so only</td>
</tr>
<tr>
<td> </td>
<td>make install-z</td>
<td>install libz.so.1.1.3</td>
</tr>
<tr>
<td> </td>
<td>make install-png</td>
<td>install libpng.so.2.1.0.7</td>
</tr>
<tr>
<td> </td>
<td>make install-jpeg</td>
<td>install libjpeg.so.62.0.0</td>
</tr>
<tr>
<td> </td>
<td>make install-tiff</td>
<td>install libtiff.so.3.5.5</td>
</tr>
<tr>
<td> </td>
<td>make install-all</td>
<td>install all of above</td>
</tr>
</tbody>
</table>
<h3>Use</h3>
<p>If you want to use the new image formats to be available in your own
scripts, add the following line somewhere in your script:</p>
<p></p>
<dl>
<dt></dt>
<dd>package require Img</dd>
</dl>
<p>This will load the library into memory and register the format handlers
into Tk.</p>
<p>As an example, have a look at the file "demo.tcl"</p>
</body>
</html>
|
