README.txt
1 "I swear by my life and my love of it that I will never live for the sake of
2 another man, nor ask another man to live for mine"
3
4 John Galt in "Atlas Shrugged", by Ayn Rand
5
6
7 AUTHOR
8
9 The author is magick-users (a] imagemagick.org. This software is NOT shareware.
10 However, I am interested in who might be using it. Please consider sending
11 me a picture postcard of the area where you live. Send postcards to
12
13 ImageMagick Studio LLC
14 P.O. Box 40
15 Landenberg, PA 19350
16 USA
17
18 I'm also interested in receiving currency or stamps from around the world
19 for my collection.
20
21
22 AVAILABILITY
23
24 ImageMagick is available as
25
26 ftp://ftp.imagemagick.org/pub/ImageMagick/ImageMagick-6.3.2-0.tar.gz
27 ftp://ftp.imagemagick.net/pub/ImageMagick/ImageMagick-6.3.2-0.tar.gz
28
29 ImageMagick client executables are available for some platforms. See
30
31 ftp://ftp.imagemagick.org/pub/ImageMagick/binaries
32 ftp://ftp.imagemagick.org/pub/ImageMagick/linux
33 ftp://ftp.imagemagick.org/pub/ImageMagick/windows
34 ftp://ftp.imagemagick.org/pub/ImageMagick/mac
35 ftp://ftp.imagemagick.org/pub/ImageMagick/vms
36
37 I want ImageMagick to be of high quality, so if you encounter a problem I
38 will investigate. However, be sure you are using the most recent version
39 from
40
41 ftp://ftp.imagemagick.org/pub/ImageMagick
42
43 before submitting any bug reports or suggestions. Report any problems via
44 the web-based reporting facility at
45
46 http://studio.imagemagick.org/mailman/listinfo/magick-bugs
47
48 WWW
49
50 The official ImageMagick WWW page is
51
52 http://www.imagemagick.org/
53 http://www.imagemagick.net/
54
55 To use display as your external image viewer, edit the global mail-cap file
56 or your personal mail-cap file .mailrc (located at your home directory) and
57 put this entry:
58
59 image/*; display %s
60
61
62 MAILING LIST
63
64 There is a mailing list for discussions and bug reports about
65 ImageMagick. To subscribe send the message
66
67 subscribe
68
69 to one of
70
71 magick-users-request (a] imagemagick.org
72 magick-developers-request (a] imagemagick.org
73 magick-bugs-request (a] imagemagick.org
74 magick-announce-request (a] imagemagick.org
75
76 You will receive a welcome message which tells you how to post messages to
77 the list.
78
79
80 CVS
81
82 ImageMagick is currently under development. It may be retrieved via CVS
83 using the following procedure:
84
85 Use
86
87 export CVSROOT=":pserver:anonymous (a] cvs.imagemagick.org:/ImageMagick"
88
89 or
90
91 setenv CVSROOT=":pserver:anonymous (a] cvs.imagemagick.org:/ImageMagick"
92
93 to set CVSROOT in the environment (depending on your shell), or prepend
94 -d followed by the CVS root to every command. For example
95
96 cvs -d ":pserver:anonymous@cvs ...
97
98 For brevity the following examples assume that CVSROOT is set in the
99 environment.
100
101 cvs login
102 [ enter "anonymous" ]
103
104 cvs co ImageMagick
105
106 If you would like to retrieve the (huge) Windows source package use
107
108 cvs co ImageMagick-NT
109
110 If you would like to retrieve *everything* associated with ImageMagick
111 (useful or not) use
112
113 cvs co ImageMagick-World
114
115
116 DOCUMENTATION
117
118 Open the file index.html in a web browser, or refer to the ImageMagick(1)
119 manual page. Also read the ImageMagick frequently asked questions in the file
120 www/FAQ.html.
121
122
123 INSTALLATION
124
125 ImageMagick may be compiled from source code for virtually any modern Unix
126 system (including Linux and MacOS X), Microsoft Windows, MacOS9, and VMS.
127 Installation instructions may be found in the following files (or their HTML
128 equivalents):
129
130 o Unix:
131
132 Install-unix.txt
133
134 o Microsoft Windows:
135
136 Install-windows.txt
137
138 o MacOS 9 (for MacOS X follow the Unix procedure):
139
140 Install-mac.txt:
141
142 o VMS:
143
144 Install-vms.txt
145
146
147 MAGICK DELEGATES
148
149 To further enhance the capabilities of ImageMagick, you may want to get these
150 programs or libraries. Note that the Windows source package (equivalent to
151 CVS module "ImageMagick-NT") includes (and builds) all of the library-based
152 packages listed here.
153
154 o ImageMagick requires the BZLIB library from
155
156 http://sources.redhat.com/bzip2/
157
158 or
159
160 ftp://sources.redhat.com/pub/bzip2/
161
162 to read and write BZip compressed MIFF images.
163
164 o ImageMagick requires ralcgm from
165
166 http://www.agocg.ac.uk/train/cgm/ralcgm.htm
167
168 to read the Computer Image Metafile (CGM) image format. You also need
169 Ghostscript (see below).
170
171 o ImageMagick requires 'dcraw' from
172
173 http://www.cybercom.net/~dcoffin/dcraw/
174
175 to read raw images from digital cameras. Try
176
177 convert crw:image image.png
178
179 o ImageMagick requires fig2dev from
180
181 ftp://ftp.x.org/contrib/applications/drawing_tools/transfig
182
183 to read the Fig image format.
184
185 o ImageMagick requires the FreeType software, version 2.0 or above, available
186 as
187
188 http://freetype.sourceforge.net
189
190 to annotate with TrueType and Postscript Type 1 fonts. Note that enabling
191 TT_CONFIG_OPTION_BYTECODE_INTERPRETER in FreeType's
192 include/freetype/config/ftoption.h will produce better glyph renderings but
193 may violate an Apple patent.
194
195 o ImageMagick requires GhostPCL software (version 1.40 recommended)
196 available from
197
198 http://www.artifex.com/downloads/
199
200 to read the PCL documents.
201
202 o ImageMagick requires Ghostscript software (version 8.10 recommended)
203 available from
204
205 http://www.cs.wisc.edu/~ghost/
206
207 to read the Postscript or the Portable Document format. Ghostscript is used
208 to annotate an image when the FreeType library is not used, or an X server
209 is not available. See the FreeType library above for another means to
210 annotate an image. Note, Ghostscript must support the ppmraw device (type
211 gs -h to verify). If Ghostscript is unavailable, the Display Postscript
212 X11 extension is used to rasterize a Postscript document (assuming you
213 define HasDPS and DPS is available). The DPS extension is less robust than
214 Ghostscript in that it will only rasterize one page of a multi-page
215 document.
216
217 Ghostscript (release 7.0 and later) may optionally install a library
218 (libgs). If this library is installed, ImageMagick may be configured to use
219 it. Note that Ghostscript provides its own modified version of libjpeg and
220 that symbols from this libjpeg may be confused with symbols with the
221 stand-alone libjpeg. If conflicts cause JPEG to fail (JPEG returns an error
222 regarding expected structure sizes), it may be necessary to use
223 Ghostscript's copy of libjpeg for ImageMagick, and all delegate libraries
224 which depend on libjpeg, or convince Ghostscript to build against an
225 unmodified installed JPEG library (and loose compatibility with some
226 Postscript files).
227
228 o ImageMagick requires hp2xx available from
229
230 http://www.gnu.org/software/hp2xx/hp2xx.html
231
232 to read the HP-GL image format. Note that HPGL is a plotter file format. HP
233 printers usually accept PCL format rather than HPGL format.
234
235 o ImageMagick requires the LCMS library available from
236
237 http://www.littlecms.com/
238
239 to perform ICC CMS color management.
240
241 o ImageMagick requires gnuplot available via anonymous FTP as
242
243 ftp://ftp.dartmouth.edu/pub/gnuplot/gnuplot-3.7.tar.gz
244
245 to read GNUPLOT plot files (with extension gplt).
246
247 o ImageMagick requires html2ps available from
248
249 http://www.tdb.uu.se/~jan/html2ps.html
250
251 to rasterize HTML files.
252
253 o ImageMagick requires the JBIG-Kit software available via HTTP from
254
255 http://www.cl.cam.ac.uk/~xml25/jbigkit/
256
257 or via anonymous FTP as
258
259 ftp://ftp.informatik.uni-erlangen.de/pub/doc/ISO/JBIG/
260
261 to read the JBIG image format.
262
263 o ImageMagick requires the Independent JPEG Group's software available via
264 anonymous FTP as
265
266 ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz
267
268 to read the JPEG v1 image format.
269
270 Apply this JPEG patch to Independent JPEG Group's source distribution if
271 you want to read lossless jpeg-encoded DICOM (medical) images:
272
273 ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/ljpeg-6b.tar.gz
274
275 Use of lossless JPEG is not encouraged. Unless you have a requirement to
276 read lossless jpeg-encoded DICOM images, please disregard the patch.
277
278 o ImageMagick requires the JasPer Project's Jasper library version 1.701.0
279 available via http from
280
281 http://www.ece.uvic.ca/~mdadams/jasper/
282
283 to read and write the JPEG-2000 format.
284
285 o ImageMagick requires the EXIF library available via http from
286
287 http://sourceforge.net/projects/libexif
288
289 to describe tags produced by most digital camera.
290
291 o ImageMagick requires the MPEG utilities from the MPEG Software Simulation
292 Group, which are available via anonymous FTP as
293
294 ftp://ftp.mpeg.org/pub/mpeg/mssg/mpeg2vidcodec_v12.tar.gz
295
296 to read or write the MPEG image format.
297
298 o ImageMagick requires the PNG library, version 1.0 or above, from
299
300 http://www.libpng.org/pub/png/pngcode.html
301
302 to read the PNG image format.
303
304 o ImageMagick requires ra_ppm from Greg Ward's Radiance software available
305 from
306
307 http://radsite.lbl.gov/radiance/HOME.html
308
309 to read the Radiance image format.
310
311 o ImageMagick requires rawtorle from the Utah Raster Toolkit available via
312 anonymous FTP as
313
314 ftp://ftp.cs.utah.edu/pub/dept/OLD/pub/urt-3.1b.tar.Z
315
316 to write the RLE image format.
317
318 o ImageMagick requires scanimage from
319
320 http://www.sane-project.org/
321
322 to import an image from a scanner device.
323
324 o ImageMagick requires Sam Leffler's TIFF software available via anonymous
325 FTP at
326
327 ftp://ftp.remotesensing.org/libtiff/
328
329 or via HTTP at
330
331 http://www.remotesensing.org/libtiff/
332
333 to read the TIFF image format. It in turn optionally requires the JPEG and
334 ZLIB libraries.
335
336 o ImageMagick requires libwmf 0.2.5 (or later) from
337
338 http://sourceforge.net/projects/wvware/
339
340 to render files in the Windows Meta File (WMF) metafile format (16-bit WMF
341 files only, not 32-bit "EMF"). This is the format commonly used for Windows
342 clipart (available on CD at your local computer or technical book store).
343 WMF support requires the FreeType 2 library in order to render TrueType and
344 Postscript fonts.
345
346 While ImageMagick uses the libwmflite (parser) component of the
347 libwmf package which does not depend on any special libraries,
348 the libwmf package as a whole depends on FreeType 2 and either the
349 xmlsoft libxml, or expat libraries. Since ImageMagick already uses
350 libxml (for reading SVG and to retrieve files via HTTP or FTP),
351 it is recommended that the options '--without-expat --with-xml'
352 be supplied to libwmf's configure script.
353
354 ImageMagick's WMF renderer provides some of the finest WMF rendering
355 available due its use of antialiased drawing algorithms. You may select a
356 background color or texture image to render on. For example, "-background
357 '#ffffffff'" renders on a transparent background while "-texture
358 plasma:fractal" renders on a fractal image.
359
360 A free set of Microsoft Windows fonts may be retrieved from
361 "http://sourceforge.net/projects/corefonts/".
362
363 o ImageMagick requires the FlashPIX library version 1.2.0 from the Digital
364 Imaging Group in order to support the FlashPIX format. The FlashPIX library
365 may be obtained from ImageMagick anonymous CVS by checking out the 'fpx'
366 module, or retrieving the file libfpx-1.2.0.9.tar.gz from the ftp
367 directory.
368
369 ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/
370
371 o ImageMagick requires an X server for the 'display', 'animate', and 'import'
372 commands to work properly. Unix systems usually provide an X server as
373 part of their standard installation.
374
375 A free X server for Microsoft Windows is available from
376
377 http://sources.redhat.com/win32-x11/
378
379 The Cygwin port of XFree86 may also be used. It is available from
380
381 http://www.cygwin.com/xfree/
382
383 There is a nearly free X server available for Windows and Macintosh at
384
385 http://www.microimages.com/freestuf/mix/
386
387 o ImageMagick requires libxml available from
388
389 http://xmlsoft.org/
390
391 to read the SVG image format and to retrieve files from over a network via
392 FTP and HTTP.
393
394 o ImageMagick requires the ZLIB library from
395
396 http://www.gzip.org/zlib/
397
398 to read or write the PNG or Zip compressed MIFF images.
399
400 o ImageMagick requires a background texture for the TILE format and for the
401 -texture option of montage(1). You can use your own or get samples from
402
403 http://the-tech.mit.edu/KPT/
404