source: general/genutils/imagemagick.xml@ e342f1a

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since e342f1a was e342f1a, checked in by Ken Moffat <ken@…>, 10 months ago

Update to ImageMagick-7.0.10-57
ftp to imagemagick.org commented, appears to no longer work.

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

  • Property mode set to 100644
File size: 22.0 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 "57">
8
9 <!ENTITY imagemagick-download-http "https://www.imagemagick.org/download/releases/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz">
10<!-- 2021-01-14 : ftp.imagemagick.org hangs, assume no longer usable
11 <!ENTITY imagemagick-download-ftp "ftp://ftp.imagemagick.org/pub/ImageMagick/releases/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz"> -->
12 <!ENTITY imagemagick-download-ftp " ">
13 <!ENTITY imagemagick-md5sum "af18570352230f8f3e71f20a775f21b4">
14 <!ENTITY imagemagick-size "9.3 MB">
15 <!ENTITY imagemagick-buildsize "191 MB (with typical dependencies; add 20 MB for checks)">
16 <!ENTITY imagemagick-time "0.9 SBU (with typical dependencies; add 0.5 SBU for checks, both using parallelism=4)">
17]>
18
19<!-- Editors: It is highly unlikely that the buildsize (disk space used) will
20 be less than the figure shown above. Unless you have installed *all* the
21 delegate dependencies, you will see a smaller buildsize, but what is
22 currently listed above is the space one would require if all the
23 dependencies available in the book are installed.
24
25 Marked as 'typical' because nobody builds ALL the optional extras [ken]
26
27 [bdubbs] I do; at least the internal ones. I still got only 141 MB.
28
29 [pierre 2017-02-14, v7.0.4-8]. I did too, and got 184 MB. I added the
30 all the corresponding switches to configure, that may make a difference.
31 All 6733 tests passed.
32
33 Saved the "full" 450MB as a comment - feel free to update this iff you
34 do build all dependencies, it's probably a lot bigger now.
35
36 [bdubbs] Just removed it. I don't think it adds anything.
37
38 [ken] Comparing 7.0.10-27 to 7.0.10-57 on the same machine: for -27 my
39 timings and space matched the book (well, make check was marginally
40 faster on this machine), but for -57 the compiled source, installed
41 files and extra space for make check were all much smaller.
42
43 Also, please look over the output from the configure command for any
44 additional dependencies that need to be listed, as ImageMagick is
45 constantly adding additional features and dependencies. Or diff the
46 configure script against the previous version.
47
48 For those of us who touch this infrequently:
49 DPS/dpsXclient is from apple so not relevant to linux builds
50 GVC is part of Graphviz and documented in the explanations
51 LQR is Liquid Rescale -->
52
53<sect1 id="imagemagick" xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
54 <?dbhtml filename="imagemagick.html"?>
55
56 <sect1info>
57 <othername>$LastChangedBy$</othername>
58 <date>$Date$</date>
59 </sect1info>
60
61 <title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
62
63 <indexterm zone="imagemagick">
64 <primary sortas="a-ImageMagick">ImageMagick</primary>
65 </indexterm>
66
67 <sect2 role="package">
68 <title>Introduction to ImageMagick</title>
69
70 <para>
71 <application>ImageMagick</application> is a collection of tools and
72 libraries to read, write, and manipulate an image in various image
73 formats. Image processing operations are available from the command line.
74 Bindings for Perl and C++ are also available.
75 </para>
76
77 &lfs10_checked;
78
79 <bridgehead renderas="sect3">Package Information</bridgehead>
80 <itemizedlist spacing="compact">
81 <listitem>
82 <para>
83 Download (HTTP): <ulink url="&imagemagick-download-http;"/></para>
84 </listitem>
85 <listitem>
86 <para>
87 Download (FTP): <ulink url="&imagemagick-download-ftp;"/></para>
88 </listitem>
89 <listitem>
90 <para>
91 Download MD5 sum: &imagemagick-md5sum;</para>
92 </listitem>
93 <listitem>
94 <para>
95 Download size: &imagemagick-size;</para>
96 </listitem>
97 <listitem>
98 <para>
99 Estimated disk space required: &imagemagick-buildsize;</para>
100 </listitem>
101 <listitem>
102 <para>
103 Estimated build time: &imagemagick-time;</para>
104 </listitem>
105 </itemizedlist>
106
107 <note>
108 <para>
109 The <application>ImageMagick</application> source releases are updated
110 frequently and the version shown above may no longer be available from
111 the download locations. You can download a more recent version and use
112 the existing BLFS instructions to install it. Chances are that it will
113 work just fine, but this has not been tested by the BLFS team. If the
114 package version shown above is not available from the locations shown
115 above, or from the <filename class='directory'>legacy/</filename>
116 directory at <literal>ftp.ImageMagick.org/pub/ImageMagick</literal> you
117 can download it from the BLFS package server at Oregon State University:
118 <ulink url="ftp://ftp.osuosl.org/pub/blfs/conglomeration/ImageMagick/"/>.
119 </para>
120 </note>
121
122 <bridgehead renderas="sect3">ImageMagick Dependencies</bridgehead>
123
124 <bridgehead renderas="sect4">Recommended</bridgehead>
125 <para role="recommended">
126 <xref linkend="xorg7-lib"/>
127 </para>
128
129 <para>
130 The optional dependencies listed below should be installed if you need
131 support for the specific format or the conversion tool the dependency
132 provides. Many of the dependencies' capabilities and uses are described in
133 the <quote>MAGICK DELEGATES</quote> section of the
134 <filename>README.txt</filename> file located in the source tree.
135 Additional information about the dependencies can be found in the
136 <filename>Install-unix.txt</filename> file located in the source tree as
137 well as issuing the <command>./configure --help</command> command. A
138 summary of this information, as well as some additional notes can be
139 viewed on-line at <ulink
140 url="https://imagemagick.org/script/advanced-unix-installation.php"/>.
141 </para>
142
143 <bridgehead renderas="sect4">Optional System Utilities</bridgehead>
144 <para role="optional">
145 Clang from <xref linkend="llvm"/>,
146 <xref linkend="cups"/>,
147 <xref linkend="curl"/>,
148 <xref linkend="ffmpeg"/>,
149 <xref linkend="fftw"/>,
150 <xref linkend="p7zip"/> (LZMA),
151 <xref linkend="sane"/>,
152 <xref linkend="wget"/>,
153 <xref linkend="xdg-utils"/>,
154 <xref linkend="xterm2"/>,
155 <ulink url="http://dmalloc.com/">Dmalloc</ulink>,
156 <ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>,
157 <ulink url="http://www.openpgp.org/about/">PGP</ulink> or
158 <xref linkend="gnupg2"/>
159 (you'll have to do some hacking to use <application>GnuPG</application>),
160 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates">Profiles</ulink>,
161 and
162 <ulink url="http://ufraw.sourceforge.net/">ufraw</ulink> (for raw formats
163 listed in
164 <ulink url="https://imagemagick.org/script/formats.php">
165 https://imagemagick.org/script/formats.php</ulink>)
166 </para>
167
168 <bridgehead renderas="sect4">Optional Graphics Libraries</bridgehead>
169 <para role="optional">
170 <xref linkend="jasper"/>,
171 <xref role="nodep" linkend="lcms"/> or
172 <xref linkend="lcms2"/>,
173 <!-- although libexif may have been used in the past, I can find no
174 evidence that it has been used in imagemagick-7. ken
175 <xref linkend="libexif"/>,-->
176 <xref linkend="libgxps"/>,
177 <xref linkend="libjpeg"/>,
178 <xref linkend="libpng"/>,
179 <xref linkend="libraw"/> (RAW_R),
180 <xref linkend="librsvg"/>,
181 <xref linkend="libtiff"/>,
182 <xref linkend="libwebp"/>,
183 <xref linkend="openjpeg2"/>,
184 <xref linkend="pango"/>,
185 <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
186 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/">
187 FlashPIX (libfpx)</ulink>,
188 <ulink url="https://github.com/FLIF-hub/FLIF/releases">FLIF</ulink>,
189 <ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
190 <!--<ulink url="&gnome-download-http;/libgxps/">libgxps</ulink>,-->
191 <ulink url="https://github.com/strukturag/libheif/">libheif</ulink>,
192 <ulink url="https://github.com/HOST-Oman/libraqm/">libraqm</ulink>,
193 <ulink url="http://liblqr.wikidot.com/en:download-page">Liquid Rescale</ulink>,
194 <ulink url="http://www.openexr.com/">OpenEXR</ulink>, and
195 <ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>
196 (or <ulink url="http://www.mcmurchy.com/ralcgm/ralcgm-3.51.tar.gz">ralcgm</ulink>)
197 </para>
198
199 <bridgehead renderas="sect4">Optional Graphics Utilities</bridgehead>
200 <para role="optional">
201 <xref linkend="dejavu-fonts"/>,
202 <xref linkend="gs"/>,
203 <xref linkend="gimp"/>,
204 <xref linkend="graphviz"/>,
205 <xref linkend="inkscape"/>,
206 <ulink url="http://www.blender.org/">Blender</ulink>,
207 <ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
208 <ulink url="http://www.ghostscript.com/download/gpcldnld.html">GhostPCL</ulink>,
209 <ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
210 <ulink url="http://www.povray.org/">POV-Ray</ulink>, and
211 <ulink url="http://www.radiance-online.org/">Radiance</ulink>
212 </para>
213
214 <bridgehead renderas="sect4">Optional Conversion Tools</bridgehead>
215 <para role="optional">
216 <xref linkend="enscript"/>,
217 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
218 <ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
219 <ulink url="http://www.lizardtech.com/downloads/category/">
220 GeoExpress Command Line Utilities, AKA MrSID Utilities (binary package)</ulink>,
221 <ulink url="https://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
222 <ulink url="http://user.it.uu.se/~jan/html2ps.html">html2ps</ulink>,
223 <ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
224 <ulink url="https://sk1project.net/uc2/">
225 UniConvertor</ulink>, and
226 <ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
227 (or <ulink url="http://www.mcmurchy.com/urt/urt-3.1b.tar.gz">URT-3.1b</ulink>)
228 </para>
229
230 <para condition="html" role="usernotes">User Notes:
231 <ulink url="&blfs-wiki;/imagemagick"/></para>
232
233 </sect2>
234
235 <sect2 role="installation">
236 <title>Installation of ImageMagick</title>
237
238 <para>
239 Install <application>ImageMagick</application> by running the following
240 commands:
241 </para>
242
243<screen><userinput>./configure --prefix=/usr \
244 --sysconfdir=/etc \
245 --enable-hdri \
246 --with-modules \
247 --with-perl \
248 --disable-static &amp;&amp;
249make</userinput></screen>
250
251 <para>
252 Now, as the <systemitem class="username">root</systemitem> user:
253 </para>
254
255<screen role="root"><userinput>make DOCUMENTATION_PATH=/usr/share/doc/imagemagick-&imagemagick-version; install</userinput></screen>
256
257 <para>
258 To test the installation, issue: <command>make check</command>. A more
259 comprehensive test is the <application>ImageMagick</application>
260 validation suite. If <command>make check</command> has not been executed,
261 run <command>make tests/validate</command> to compile it. Issue
262 <command>tests/validate 2>&amp;1 | tee validate.log</command> to run the
263 validation suite. <!-- summary is last line of output
264 The result summary may be obtained with <command>grep
265 "validation suite" validate.log</command>. -->
266 <!-- I'm not convinced that Helvetica is required, I don't install the gs
267 fonts. But lots of references to it. Surely fontconfig provides it? ken -->
268 Note that the EPS, PS, and PDF
269 tests require a working <application>Ghostscript</application>. One test
270 in 'make check' needs <quote>Helvetica</quote> from <quote>Ghostscript
271 Standard Fonts</quote>, which are optionally installed in
272 <xref linkend="gs"/> - that test, and one other, might fail, but all the
273 validation can still pass.
274 </para>
275
276 </sect2>
277
278 <sect2 role="commands">
279 <title>Command Explanations</title>
280
281 <para>
282 <parameter>--enable-hdri</parameter>: Enables building of a
283 high dynamic range version of ImageMagick.
284 </para>
285
286 <para>
287 <parameter>--with-modules</parameter>: Enables support for
288 dynamically loadable modules.
289 </para>
290
291 <para>
292 <parameter>--with-perl</parameter>: Enables building and
293 installing of PerlMagick.
294 </para>
295
296 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
297 href="../../xincludes/static-libraries.xml"/>
298
299 <para>
300 <option>--with-gslib</option>: Enables support to use the
301 <application>Ghostscript</application> shared library.
302 </para>
303
304 <para>
305 <option>--with-rsvg</option>: Enables support to use the
306 <application>librsvg</application> library.
307 </para>
308
309 <para>
310 <option>--with-autotrace</option>: Enables support to use
311 the <application>Autotrace</application> library.
312 </para>
313
314 <para>
315 <option>--with-wmf</option>: Enables support to use the
316 <application>libwmf</application> library.
317 </para>
318
319 <para>
320 <option>--with-gvc</option>: Enables support to use
321 <application>GraphViz</application>.
322 </para>
323
324 <para>
325 <option>--with-windows-font-dir=
326 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
327 This option specifies the directory where the Windows CoreFonts are
328 installed.
329 </para>
330
331 <para>
332 <option>--with-dejavu-font-dir=
333 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
334 This option specifies the directory where the DejaVu fonts are
335 installed.
336 </para>
337
338 <para>
339 The options and parameters listed above are the only ones you should
340 have to pass to the <command>configure</command> script to activate all
341 the delegate dependencies. All other dependencies will be automatically
342 detected and utilized in the build if they are installed.
343 </para>
344
345 </sect2>
346
347 <sect2 role="content">
348 <title>Contents</title>
349
350 <segmentedlist>
351 <segtitle>Installed Programs</segtitle>
352 <segtitle>Installed Libraries</segtitle>
353 <segtitle>Installed Directories</segtitle>
354
355 <seglistitem>
356 <seg>
357 magick, Magick++-config, MagickCore-config, and MagickWand-config.
358 (animate, compare, composite, conjure, convert, display,
359 identify, import, magick-script, mogrify, montage, and stream
360 are all symbolic links to magick)
361 </seg>
362 <seg>
363 libMagickCore-7.Q16HDRI.so,
364 libMagickWand-7.Q16HDRI.so and
365 libMagick++-7.Q16HDRI.so
366 </seg>
367 <seg>
368 /etc/ImageMagick-7,
369 /usr/include/ImageMagick-7,
370 /usr/lib/ImageMagick-&imagemagick-version;,
371 /usr/lib/perl5/site_perl/&lfs-perl-version;/{,auto}/Image/Magick,
372 /usr/share/doc/ImageMagick-&imagemagick-version;, and
373 /usr/share/ImageMagick-7
374 </seg>
375 </seglistitem>
376 </segmentedlist>
377
378 <variablelist>
379 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
380 <?dbfo list-presentation="list"?>
381 <?dbhtml list-presentation="table"?>
382
383 <varlistentry id="animate">
384 <term><command>animate</command></term>
385 <listitem>
386 <para>
387 animates a sequence of images.
388 </para>
389 <indexterm zone="imagemagick animate">
390 <primary sortas="b-animate">animate</primary>
391 </indexterm>
392 </listitem>
393 </varlistentry>
394
395 <varlistentry id="compare">
396 <term><command>compare</command></term>
397 <listitem>
398 <para>
399 compares an image to a reconstructed image.
400 </para>
401 <indexterm zone="imagemagick compare">
402 <primary sortas="b-compare">compare</primary>
403 </indexterm>
404 </listitem>
405 </varlistentry>
406
407 <varlistentry id="composite">
408 <term><command>composite</command></term>
409 <listitem>
410 <para>
411 composites various images into the given base image.
412 </para>
413 <indexterm zone="imagemagick composite">
414 <primary sortas="b-composite">composite</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 <varlistentry id="conjure">
420 <term><command>conjure</command></term>
421 <listitem>
422 <para>
423 processes a MSL script to create an image.
424 </para>
425 <indexterm zone="imagemagick conjure">
426 <primary sortas="b-conjure">conjure</primary>
427 </indexterm>
428 </listitem>
429 </varlistentry>
430
431 <varlistentry id="convert">
432 <term><command>convert</command></term>
433 <listitem>
434 <para>
435 converts image(s) from one format to another.
436 </para>
437 <indexterm zone="imagemagick convert">
438 <primary sortas="b-convert">convert</primary>
439 </indexterm>
440 </listitem>
441 </varlistentry>
442
443 <varlistentry id="display">
444 <term><command>display</command></term>
445 <listitem>
446 <para>
447 displays an image.
448 </para>
449 <indexterm zone="imagemagick display">
450 <primary sortas="b-display">display</primary>
451 </indexterm>
452 </listitem>
453 </varlistentry>
454
455 <varlistentry id="identify">
456 <term><command>identify</command></term>
457 <listitem>
458 <para>
459 describes the format and characteristics of an image file.
460 </para>
461 <indexterm zone="imagemagick identify">
462 <primary sortas="b-identify">identify</primary>
463 </indexterm>
464 </listitem>
465 </varlistentry>
466
467 <varlistentry id="import">
468 <term><command>import</command></term>
469 <listitem>
470 <para>
471 captures an X window.
472 </para>
473 <indexterm zone="imagemagick import">
474 <primary sortas="b-import">import</primary>
475 </indexterm>
476 </listitem>
477 </varlistentry>
478
479 <varlistentry id="magick">
480 <term><command>magick</command></term>
481 <listitem>
482 <para>
483 convert between image formats as well as resize an image,
484 blur, crop, despeckle, dither, draw on, flip, join, re-sample
485 and much more.
486 </para>
487 <indexterm zone="imagemagick magick">
488 <primary sortas="b-magick">magick</primary>
489 </indexterm>
490 </listitem>
491 </varlistentry>
492
493 <varlistentry id="magick-config">
494 <term><command>Magick{++,Core,Wand}-config</command></term>
495 <listitem>
496 <para>
497 show information about the installed versions of the
498 <application>ImageMagick</application> libraries.
499 </para>
500 <indexterm zone="imagemagick magick-config">
501 <primary sortas="b-Magick-config">Magick-config</primary>
502 </indexterm>
503 </listitem>
504 </varlistentry>
505
506 <varlistentry id="mogrify">
507 <term><command>mogrify</command></term>
508 <listitem>
509 <para>
510 transforms an image.
511 </para>
512 <indexterm zone="imagemagick mogrify">
513 <primary sortas="b-mogrify">mogrify</primary>
514 </indexterm>
515 </listitem>
516 </varlistentry>
517
518 <varlistentry id="montage">
519 <term><command>montage</command></term>
520 <listitem>
521 <para>
522 composites various images into a new image.
523 </para>
524 <indexterm zone="imagemagick montage">
525 <primary sortas="b-montage">montage</primary>
526 </indexterm>
527 </listitem>
528 </varlistentry>
529
530 <varlistentry id="stream">
531 <term><command>stream</command></term>
532 <listitem>
533 <para>
534 streams one or more pixel components of an image or
535 portion of the image to your choice of storage formats.
536 </para>
537 <indexterm zone="imagemagick stream">
538 <primary sortas="b-stream">stream</primary>
539 </indexterm>
540 </listitem>
541 </varlistentry>
542
543 <varlistentry id="perlmagick">
544 <term><filename class='libraryfile'>Image::Magick</filename></term>
545 <listitem>
546 <para>
547 allows the reading, manipulation and writing of a large number of
548 image file formats using the <application>ImageMagick</application>
549 library. Run <command>make</command> in the
550 <filename class='directory'>PerlMagick/demo</filename> directory of
551 the package source tree after the package is installed to see a nice
552 demo of the module's capabilities.
553 </para>
554 <indexterm zone="imagemagick perlmagick">
555 <primary sortas="g-Image-Magick">Image::Magick</primary>
556 </indexterm>
557 </listitem>
558 </varlistentry>
559
560 <varlistentry id="libMagickCore-7.Q16HDRI">
561 <term><filename class="libraryfile">libMagickCore-7.Q16HDRI.so</filename></term>
562 <listitem>
563 <para>
564 provides the C API for ImageMagick.
565 </para>
566 <indexterm zone="imagemagick libMagickCore-7.Q16HDRI">
567 <primary sortas="c-libMagickCore-7.Q16HDRI">libMagickCore-7.Q16HDRI.so</primary>
568 </indexterm>
569 </listitem>
570 </varlistentry>
571
572 <varlistentry id="libMagickWand-7.Q16HDRI">
573 <term><filename class="libraryfile">libMagickWand-7.Q16HDRI.so</filename></term>
574 <listitem>
575 <para>
576 is the recommended C API for ImageMagick. Unlike the MagickCore API it
577 uses only a few opaque types.
578 </para>
579 <indexterm zone="imagemagick libMagickWand-7.Q16HDRI">
580 <primary sortas="c-libMagickWand-7.Q16HDRI">libMagickWand-7.Q16HDRI.so</primary>
581 </indexterm>
582 </listitem>
583 </varlistentry>
584
585 <varlistentry id="libMagickpp-7.Q16HDRI">
586 <term><filename class="libraryfile">libMagick++-7.Q16HDRI.so</filename></term>
587 <listitem>
588 <para>
589 provides the C++ API for ImageMagick.
590 </para>
591 <indexterm zone="imagemagick libMagickpp-7.Q16HDRI">
592 <primary sortas="c-libMagick++-7.Q16HDRI">libMagick++-7.Q16HDRI.so</primary>
593 </indexterm>
594 </listitem>
595 </varlistentry>
596
597 </variablelist>
598
599 </sect2>
600
601</sect1>
Note: See TracBrowser for help on using the repository browser.