source: general/genutils/imagemagick.xml@ a29486e4

10.0 10.1 11.0 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a29486e4 was a29486e4, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Update locations of files hosted on anduin

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16519 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 18.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY imagemagick-patch-version "0">
8
9 <!ENTITY imagemagick-download-http " ">
10 <!ENTITY imagemagick-download-ftp "ftp://ftp.imagemagick.org/pub/ImageMagick/releases/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz">
11 <!ENTITY imagemagick-md5sum "99471c8c3f38c9264faf5c4ca7a31287">
12 <!ENTITY imagemagick-size "7.9 MB">
13 <!ENTITY imagemagick-buildsize "192 MB, with typical dependencies (227 MB with the test suite, reputedly 450 MB with all dependencies)">
14 <!ENTITY imagemagick-time "2.2 SBU - typical build (additional 3.4 SBU to run the test suite and 3.3 SBU to run the validation suite)">
15]>
16
17<!-- Editors: It is highly unlikely that the buildsize (disk space used) will
18 be less than the figure shown above. Unless you have installed *all* the
19 delegate dependencies, you will see a smaller buildsize, but what is
20 currently listed above is the space one would require if all the
21 dependencies are installed, which is what we want.
22
23 Marked as 'typical' because nobody builds ALL the optional extras [ken]
24 Saved the "full" 450MB as a comment - feel free to update this iff you
25 do build all dependencies, it's probably a lot bigger now.
26
27 Also, please look over the output from the configure command for any
28 additional dependencies that need to be listed, as ImageMagick is
29 constantly adding additional features and dependencies. -->
30
31<sect1 id="imagemagick" xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
32 <?dbhtml filename="imagemagick.html"?>
33
34 <sect1info>
35 <othername>$LastChangedBy$</othername>
36 <date>$Date$</date>
37 </sect1info>
38
39 <title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
40
41 <indexterm zone="imagemagick">
42 <primary sortas="a-ImageMagick">ImageMagick</primary>
43 </indexterm>
44
45 <sect2 role="package">
46 <title>Introduction to ImageMagick</title>
47
48 <para>
49 <application>ImageMagick</application> is a collection of tools and
50 libraries to read, write, and manipulate an image in various image formats.
51 Image processing operations are available from the command line. Bindings
52 for Perl and C++ are also available.
53 </para>
54
55 &lfs78_checked;
56
57 <bridgehead renderas="sect3">Package Information</bridgehead>
58 <itemizedlist spacing="compact">
59 <listitem>
60 <para>Download (HTTP): <ulink url="&imagemagick-download-http;"/></para>
61 </listitem>
62 <listitem>
63 <para>Download (FTP): <ulink url="&imagemagick-download-ftp;"/></para>
64 </listitem>
65 <listitem>
66 <para>Download MD5 sum: &imagemagick-md5sum;</para>
67 </listitem>
68 <listitem>
69 <para>Download size: &imagemagick-size;</para>
70 </listitem>
71 <listitem>
72 <para>Estimated disk space required: &imagemagick-buildsize;</para>
73 </listitem>
74 <listitem>
75 <para>Estimated build time: &imagemagick-time;</para>
76 </listitem>
77 </itemizedlist>
78
79 <note>
80 <para>
81 The <application>ImageMagick</application> source releases are
82 updated frequently and the version shown above may no longer be available
83 from the download locations. You can download a more recent version and use
84 the existing BLFS instructions to install it. Chances are that it will
85 work just fine, but this has not been tested by the BLFS team. If the
86 package version shown above is not available from the locations shown
87 above, or from the <filename class='directory'>legacy/</filename> directory
88 at <literal>ftp.ImageMagick.org/pub/ImageMagick</literal> you can download it
89 from the BLFS package server at <ulink
90 url="&sources-anduin-http;/ImageMagick/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz"/>.
91 </para>
92 </note>
93
94 <bridgehead renderas="sect3">ImageMagick Dependencies</bridgehead>
95
96 <bridgehead renderas="sect4">Recommended</bridgehead>
97 <para role="recommended">
98 <xref linkend="xorg7-lib"/>
99 </para>
100
101 <para>
102 The optional dependencies listed below should be installed if you
103 need support for the specific format or the conversion tool the dependency
104 provides. Many of the dependencies' capabilities and uses are described in
105 the <quote>MAGICK DELEGATES</quote> section of the
106 <filename>README.txt</filename> file located in the source tree. Additional
107 information about the dependencies can be found in the
108 <filename>Install-unix.txt</filename> file located in the source tree as
109 well as issuing the <command>./configure --help</command> command. A
110 summary of this information, as well as some additional notes can be viewed
111 on-line at <ulink
112 url="http://www.imagemagick.org/script/advanced-unix-installation.php"/>.
113 </para>
114
115 <bridgehead renderas="sect4">Optional System Utilities</bridgehead>
116 <para role="optional">
117 <xref linkend="cups"/>,
118 <xref linkend="curl"/>,
119 <xref linkend="ffmpeg"/>,
120 <xref linkend="p7zip"/> (LZMA),
121 <xref linkend="sane"/>,
122 <xref linkend="wget"/>,
123 <xref linkend="xdg-utils"/>,
124 <xref linkend="xterm2"/>,
125 <ulink url="http://dmalloc.com/">Dmalloc</ulink>,
126 <ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>,
127 <ulink url="http://www.fftw.org/">FFTW</ulink>,
128 <ulink url="http://www.openpgp.org/resources/downloads">PGP</ulink> or
129 <xref linkend="gnupg2"/>
130 (you'll have to do some hacking to use <application>GnuPG</application>),
131 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/profiles.zip">Profiles</ulink>, and
132 <ulink url="http://ufraw.sourceforge.net/">ufraw</ulink> (for raw formats listed in
133 <filename>www/formats.html</filename>)
134 </para>
135
136 <bridgehead renderas="sect4">Optional Graphics Libraries</bridgehead>
137 <para role="optional">
138 <xref linkend="jasper"/>,
139 <xref linkend="lcms"/> or
140 <xref linkend="lcms2"/>,
141 <xref linkend="libexif"/>,
142 <xref linkend="libjpeg"/>,
143 <xref linkend="libpng"/>,
144 <xref linkend="librsvg"/>,
145 <xref linkend="libtiff"/>,
146 <xref linkend="libwebp"/>,
147 <xref linkend="openjpeg2"/>,
148 <xref linkend="pango"/>,
149 <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
150 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/">
151 FlashPIX (libfpx)</ulink>,
152 <ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
153 <ulink url="&gnome-download-http;/libgxps/">libgxps</ulink>,
154 <ulink url="http://liblqr.wikidot.com/en:download-page">Liquid Rescale</ulink>,
155 <ulink url="http://www.openexr.com/">OpenEXR</ulink>, and
156 <ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>
157 (or <ulink url="http://www.mcmurchy.com/ralcgm/ralcgm-3.51.tar.gz">ralcgm</ulink>)
158 </para>
159
160 <bridgehead renderas="sect4">Optional Graphics Utilities</bridgehead>
161 <para role="optional">
162 <xref linkend="gs"/>,
163 <xref linkend="gimp"/>,
164 <xref linkend="graphviz"/>,
165 <xref linkend="inkscape"/>,
166 <ulink url="http://www.blender.org/">Blender</ulink>,
167 <ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
168 <ulink url="http://dejavu.sourceforge.net/">DejaVu fonts</ulink>,
169 <ulink url="http://www.ghostscript.com/download/gpcldnld.html">GhostPCL</ulink>,
170 <ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
171 <ulink url="http://www.povray.org/">POV-Ray</ulink>, and
172 <ulink url="http://www.radiance-online.org/">Radiance</ulink>
173 </para>
174
175 <bridgehead renderas="sect4">Optional Conversion Tools</bridgehead>
176 <para role="optional">
177 <xref linkend="enscript"/>,
178 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
179 <ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
180 <ulink url="http://www.lizardtech.com/downloads/category/">
181 GeoExpress Command Line Utilities, AKA MrSID Utilities (binary package)</ulink>,
182 <ulink url="http://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
183 <ulink url="http://user.it.uu.se/~jan/html2ps.html">html2ps</ulink>,
184 <ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
185 <ulink url="http://sk1project.org/modules.php?name=products&amp;product=uniconvertor">
186 UniConvertor</ulink>, and
187 <ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
188 (or <ulink url="http://www.mcmurchy.com/urt/urt-3.1b.tar.gz">URT-3.1b</ulink>)
189 </para>
190
191 <para condition="html" role="usernotes">User Notes:
192 <ulink url="&blfs-wiki;/imagemagick"/></para>
193
194 </sect2>
195
196 <sect2 role="installation">
197 <title>Installation of ImageMagick</title>
198
199 <para>
200 Install <application>ImageMagick</application> by running the following commands:
201 </para>
202
203<screen><userinput>./configure --prefix=/usr \
204 --sysconfdir=/etc \
205 --enable-hdri \
206 --with-modules \
207 --with-perl \
208 --disable-static &amp;&amp;
209make</userinput></screen>
210
211 <para>
212 Now, as the <systemitem class="username">root</systemitem> user:
213 </para>
214
215<screen role="root"><userinput>make DOCUMENTATION_PATH=/usr/share/doc/imagemagick-&imagemagick-version; install</userinput></screen>
216
217 <para>
218 To test the installation, issue: <command>make check</command>. A more
219 comprehensive test is the <application>ImageMagick</application>
220 validation suite. If <command>make check</command> has not been executed,
221 run <command>make tests/validate</command> to compile it. Issue
222 <command>tests/validate 2>&amp;1 | tee validate.log</command> to run the
223 validation suite. The result summary may be obtained with <command>grep
224 "validation suite" validate.log</command>. Note that the EPS, PS, and PDF
225 tests require a working <application>Ghostscript</application>. One test
226 needs <quote>Helvetica</quote> from <quote>Ghostscript Standard
227 Fonts</quote>, which are optionally installed in <xref linkend="gs"/>.
228 </para>
229
230 </sect2>
231
232 <sect2 role="commands">
233 <title>Command Explanations</title>
234
235 <para>
236 <parameter>--enable-hdri</parameter>: Enables building of a
237 high dynamic range version of ImageMagick.
238 </para>
239
240 <para>
241 <parameter>--with-modules</parameter>: Enables support for
242 dynamically loadable modules.
243 </para>
244
245 <para>
246 <parameter>--with-perl</parameter>: Enables building and
247 installing of PerlMagick.
248 </para>
249
250 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
251 href="../../xincludes/static-libraries.xml"/>
252
253 <para>
254 <option>--with-gslib</option>: Enables support to use the
255 <application>Ghostscript</application> shared library.
256 </para>
257
258 <para>
259 <option>--with-rsvg</option>: Enables support to use the
260 <application>librsvg</application> library.
261 </para>
262
263 <para>
264 <option>--with-autotrace</option>: Enables support to use
265 the <application>Autotrace</application> library.
266 </para>
267
268 <para>
269 <option>--with-wmf</option>: Enables support to use the
270 <application>libwmf</application> library.
271 </para>
272
273 <para>
274 <option>--with-gvc</option>: Enables support to use
275 <application>GraphViz</application>.
276 </para>
277
278 <para>
279 <option>--with-windows-font-dir=
280 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
281 This option specifies the directory where the Windows CoreFonts are
282 installed.
283 </para>
284
285 <para>
286 <option>--with-dejavu-font-dir=
287 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
288 This option specifies the directory where the DejaVu fonts are
289 installed.
290 </para>
291
292 <para>
293 The options and parameters listed above are the only ones you should
294 have to pass to the <command>configure</command> script to activate all
295 the delegate dependencies. All other dependencies will be automatically
296 detected and utilized in the build if they are installed.
297 </para>
298
299 </sect2>
300
301 <sect2 role="content">
302 <title>Contents</title>
303
304 <segmentedlist>
305 <segtitle>Installed Programs</segtitle>
306 <segtitle>Installed Libraries</segtitle>
307 <segtitle>Installed Directories</segtitle>
308
309 <seglistitem>
310 <seg>
311 animate, compare, composite, conjure, convert, display,
312 identify, import, Magick-config, Magick++-config, MagickCore-config,
313 MagickWand-config, mogrify, montage, stream, and Wand-config
314 </seg>
315 <seg>
316 libMagickCore-6.Q16HDRI.so,
317 libMagickWand-6.Q16HDRI.so and
318 libMagick++-6.Q16HDRI.so
319 </seg>
320 <seg>
321 /etc/ImageMagick-6,
322 /usr/include/ImageMagick-6,
323 /usr/lib/ImageMagick-&imagemagick-version;,
324 /usr/lib/perl5/site_perl/&lfs-perl-version;/{,auto}/Image/Magick,
325 /usr/share/doc/ImageMagick-&imagemagick-version;, and
326 /usr/share/ImageMagick-6
327 </seg>
328 </seglistitem>
329 </segmentedlist>
330
331 <variablelist>
332 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
333 <?dbfo list-presentation="list"?>
334 <?dbhtml list-presentation="table"?>
335
336 <varlistentry id="animate">
337 <term><command>animate</command></term>
338 <listitem>
339 <para>animates a sequence of images.</para>
340 <indexterm zone="imagemagick animate">
341 <primary sortas="b-animate">animate</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="compare">
347 <term><command>compare</command></term>
348 <listitem>
349 <para>compares an image to a reconstructed image.</para>
350 <indexterm zone="imagemagick compare">
351 <primary sortas="b-compare">compare</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="composite">
357 <term><command>composite</command></term>
358 <listitem>
359 <para>composites various images into the given base image.</para>
360 <indexterm zone="imagemagick composite">
361 <primary sortas="b-composite">composite</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="conjure">
367 <term><command>conjure</command></term>
368 <listitem>
369 <para>processes a MSL script to create an image.</para>
370 <indexterm zone="imagemagick conjure">
371 <primary sortas="b-conjure">conjure</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="convert">
377 <term><command>convert</command></term>
378 <listitem>
379 <para>converts image(s) from one format to another.</para>
380 <indexterm zone="imagemagick convert">
381 <primary sortas="b-convert">convert</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="display">
387 <term><command>display</command></term>
388 <listitem>
389 <para>displays an image.</para>
390 <indexterm zone="imagemagick display">
391 <primary sortas="b-display">display</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="identify">
397 <term><command>identify</command></term>
398 <listitem>
399 <para>describes the format and characteristics of an image file.</para>
400 <indexterm zone="imagemagick identify">
401 <primary sortas="b-identify">identify</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="import">
407 <term><command>import</command></term>
408 <listitem>
409 <para>captures an X window.</para>
410 <indexterm zone="imagemagick import">
411 <primary sortas="b-import">import</primary>
412 </indexterm>
413 </listitem>
414 </varlistentry>
415
416 <varlistentry id="magick-config">
417 <term><command>Magick{,++,Core,Wand}-config</command></term>
418 <listitem>
419 <para>show information about the installed versions of the
420 <application>ImageMagick</application> libraries.</para>
421 <indexterm zone="imagemagick magick-config">
422 <primary sortas="b-Magick-config">Magick-config</primary>
423 </indexterm>
424 </listitem>
425 </varlistentry>
426
427 <varlistentry id="mogrify">
428 <term><command>mogrify</command></term>
429 <listitem>
430 <para>transforms an image.</para>
431 <indexterm zone="imagemagick mogrify">
432 <primary sortas="b-mogrify">mogrify</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 <varlistentry id="montage">
438 <term><command>montage</command></term>
439 <listitem>
440 <para>composites various images into a new image.</para>
441 <indexterm zone="imagemagick montage">
442 <primary sortas="b-montage">montage</primary>
443 </indexterm>
444 </listitem>
445 </varlistentry>
446
447 <varlistentry id="stream">
448 <term><command>stream</command></term>
449 <listitem>
450 <para>streams one or more pixel components of an image or
451 portion of the image to your choice of storage formats.</para>
452 <indexterm zone="imagemagick stream">
453 <primary sortas="b-stream">stream</primary>
454 </indexterm>
455 </listitem>
456 </varlistentry>
457
458 <varlistentry id="wand-config">
459 <term><command>Wand-config</command></term>
460 <listitem>
461 <para>shows the options required to use the Wand library.</para>
462 <indexterm zone="imagemagick wand-config">
463 <primary sortas="b-Wand-config">Wand-config</primary>
464 </indexterm>
465 </listitem>
466 </varlistentry>
467
468 <varlistentry id="perlmagick">
469 <term><filename class='libraryfile'>Image::Magick</filename></term>
470 <listitem>
471 <para>allows the reading, manipulation and writing of a large number of
472 image file formats using the <application>ImageMagick</application>
473 library. Run <command>make</command> in the
474 <filename class='directory'>PerlMagick/demo</filename> directory of
475 the package source tree after the package is installed to see a nice
476 demo of the module's capabilities.</para>
477 <indexterm zone="imagemagick perlmagick">
478 <primary sortas="g-Image-Magick">Image::Magick</primary>
479 </indexterm>
480 </listitem>
481 </varlistentry>
482
483 </variablelist>
484
485 </sect2>
486
487</sect1>
Note: See TracBrowser for help on using the repository browser.