source: general/genutils/imagemagick.xml@ d21c58fe

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 d21c58fe was d21c58fe, checked in by Ken Moffat <ken@…>, 8 months ago

Update to ImageMagick-7.0.11-0

Also mention libde265 as a dependency of libheif for both IM7 and gimp.

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

  • Property mode set to 100644
File size: 22.1 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 "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 "660bf750511926bd9bbb46f3f5f36fab">
14 <!ENTITY imagemagick-size "9.7 MB">
15 <!ENTITY imagemagick-buildsize "203 MB (with typical dependencies; add 19 MB for checks)">
16 <!ENTITY imagemagick-time "0.8 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> with
192 <ulink url="https://github.com/strukturag/libde265/">libde265</ulink>
193 (both needed if converting macOS heic images),
194 <ulink url="https://github.com/HOST-Oman/libraqm/">libraqm</ulink>,
195 <ulink url="http://liblqr.wikidot.com/en:download-page">Liquid Rescale</ulink>,
196 <ulink url="http://www.openexr.com/">OpenEXR</ulink>, and
197 <ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>
198 (or <ulink url="http://www.mcmurchy.com/ralcgm/ralcgm-3.51.tar.gz">ralcgm</ulink>)
199 </para>
200
201 <bridgehead renderas="sect4">Optional Graphics Utilities</bridgehead>
202 <para role="optional">
203 <xref linkend="dejavu-fonts"/>,
204 <xref linkend="gs"/>,
205 <xref linkend="gimp"/>,
206 <xref linkend="graphviz"/>,
207 <xref linkend="inkscape"/>,
208 <ulink url="http://www.blender.org/">Blender</ulink>,
209 <ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
210 <ulink url="http://www.ghostscript.com/download/gpcldnld.html">GhostPCL</ulink>,
211 <ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
212 <ulink url="http://www.povray.org/">POV-Ray</ulink>, and
213 <ulink url="http://www.radiance-online.org/">Radiance</ulink>
214 </para>
215
216 <bridgehead renderas="sect4">Optional Conversion Tools</bridgehead>
217 <para role="optional">
218 <xref linkend="enscript"/>,
219 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
220 <ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
221 <ulink url="http://www.lizardtech.com/downloads/category/">
222 GeoExpress Command Line Utilities, AKA MrSID Utilities (binary package)</ulink>,
223 <ulink url="https://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
224 <ulink url="http://user.it.uu.se/~jan/html2ps.html">html2ps</ulink>,
225 <ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
226 <ulink url="https://sk1project.net/uc2/">
227 UniConvertor</ulink>, and
228 <ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
229 (or <ulink url="http://www.mcmurchy.com/urt/urt-3.1b.tar.gz">URT-3.1b</ulink>)
230 </para>
231
232 <para condition="html" role="usernotes">User Notes:
233 <ulink url="&blfs-wiki;/imagemagick"/></para>
234
235 </sect2>
236
237 <sect2 role="installation">
238 <title>Installation of ImageMagick</title>
239
240 <para>
241 Install <application>ImageMagick</application> by running the following
242 commands:
243 </para>
244
245<screen><userinput>./configure --prefix=/usr \
246 --sysconfdir=/etc \
247 --enable-hdri \
248 --with-modules \
249 --with-perl \
250 --disable-static &amp;&amp;
251make</userinput></screen>
252
253 <para>
254 Now, as the <systemitem class="username">root</systemitem> user:
255 </para>
256
257<screen role="root"><userinput>make DOCUMENTATION_PATH=/usr/share/doc/imagemagick-&imagemagick-version; install</userinput></screen>
258
259 <para>
260 To test the installation, issue: <command>make check</command>. A more
261 comprehensive test is the <application>ImageMagick</application>
262 validation suite. If <command>make check</command> has not been executed,
263 run <command>make tests/validate</command> to compile it. Issue
264 <command>tests/validate 2>&amp;1 | tee validate.log</command> to run the
265 validation suite. <!-- summary is last line of output
266 The result summary may be obtained with <command>grep
267 "validation suite" validate.log</command>. -->
268 <!-- I'm not convinced that Helvetica is required, I don't install the gs
269 fonts. But lots of references to it. Surely fontconfig provides it? ken -->
270 Note that the EPS, PS, and PDF
271 tests require a working <application>Ghostscript</application>. One test
272 in 'make check' needs <quote>Helvetica</quote> from <quote>Ghostscript
273 Standard Fonts</quote>, which are optionally installed in
274 <xref linkend="gs"/> - that test, and one other, might fail, but all the
275 validation can still pass.
276 </para>
277
278 </sect2>
279
280 <sect2 role="commands">
281 <title>Command Explanations</title>
282
283 <para>
284 <parameter>--enable-hdri</parameter>: Enables building of a
285 high dynamic range version of ImageMagick.
286 </para>
287
288 <para>
289 <parameter>--with-modules</parameter>: Enables support for
290 dynamically loadable modules.
291 </para>
292
293 <para>
294 <parameter>--with-perl</parameter>: Enables building and
295 installing of PerlMagick.
296 </para>
297
298 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
299 href="../../xincludes/static-libraries.xml"/>
300
301 <para>
302 <option>--with-gslib</option>: Enables support to use the
303 <application>Ghostscript</application> shared library.
304 </para>
305
306 <para>
307 <option>--with-rsvg</option>: Enables support to use the
308 <application>librsvg</application> library.
309 </para>
310
311 <para>
312 <option>--with-autotrace</option>: Enables support to use
313 the <application>Autotrace</application> library.
314 </para>
315
316 <para>
317 <option>--with-wmf</option>: Enables support to use the
318 <application>libwmf</application> library.
319 </para>
320
321 <para>
322 <option>--with-gvc</option>: Enables support to use
323 <application>GraphViz</application>.
324 </para>
325
326 <para>
327 <option>--with-windows-font-dir=
328 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
329 This option specifies the directory where the Windows CoreFonts are
330 installed.
331 </para>
332
333 <para>
334 <option>--with-dejavu-font-dir=
335 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
336 This option specifies the directory where the DejaVu fonts are
337 installed.
338 </para>
339
340 <para>
341 The options and parameters listed above are the only ones you should
342 have to pass to the <command>configure</command> script to activate all
343 the delegate dependencies. All other dependencies will be automatically
344 detected and utilized in the build if they are installed.
345 </para>
346
347 </sect2>
348
349 <sect2 role="content">
350 <title>Contents</title>
351
352 <segmentedlist>
353 <segtitle>Installed Programs</segtitle>
354 <segtitle>Installed Libraries</segtitle>
355 <segtitle>Installed Directories</segtitle>
356
357 <seglistitem>
358 <seg>
359 magick, Magick++-config, MagickCore-config, and MagickWand-config.
360 (animate, compare, composite, conjure, convert, display,
361 identify, import, magick-script, mogrify, montage, and stream
362 are all symbolic links to magick)
363 </seg>
364 <seg>
365 libMagickCore-7.Q16HDRI.so,
366 libMagickWand-7.Q16HDRI.so and
367 libMagick++-7.Q16HDRI.so
368 </seg>
369 <seg>
370 /etc/ImageMagick-7,
371 /usr/include/ImageMagick-7,
372 /usr/lib/ImageMagick-&imagemagick-version;,
373 /usr/lib/perl5/site_perl/&lfs-perl-version;/{,auto}/Image/Magick,
374 /usr/share/doc/ImageMagick-&imagemagick-version;, and
375 /usr/share/ImageMagick-7
376 </seg>
377 </seglistitem>
378 </segmentedlist>
379
380 <variablelist>
381 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
382 <?dbfo list-presentation="list"?>
383 <?dbhtml list-presentation="table"?>
384
385 <varlistentry id="animate">
386 <term><command>animate</command></term>
387 <listitem>
388 <para>
389 animates a sequence of images.
390 </para>
391 <indexterm zone="imagemagick animate">
392 <primary sortas="b-animate">animate</primary>
393 </indexterm>
394 </listitem>
395 </varlistentry>
396
397 <varlistentry id="compare">
398 <term><command>compare</command></term>
399 <listitem>
400 <para>
401 compares an image to a reconstructed image.
402 </para>
403 <indexterm zone="imagemagick compare">
404 <primary sortas="b-compare">compare</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="composite">
410 <term><command>composite</command></term>
411 <listitem>
412 <para>
413 composites various images into the given base image.
414 </para>
415 <indexterm zone="imagemagick composite">
416 <primary sortas="b-composite">composite</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 <varlistentry id="conjure">
422 <term><command>conjure</command></term>
423 <listitem>
424 <para>
425 processes a MSL script to create an image.
426 </para>
427 <indexterm zone="imagemagick conjure">
428 <primary sortas="b-conjure">conjure</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 <varlistentry id="convert">
434 <term><command>convert</command></term>
435 <listitem>
436 <para>
437 converts image(s) from one format to another.
438 </para>
439 <indexterm zone="imagemagick convert">
440 <primary sortas="b-convert">convert</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="display">
446 <term><command>display</command></term>
447 <listitem>
448 <para>
449 displays an image.
450 </para>
451 <indexterm zone="imagemagick display">
452 <primary sortas="b-display">display</primary>
453 </indexterm>
454 </listitem>
455 </varlistentry>
456
457 <varlistentry id="identify">
458 <term><command>identify</command></term>
459 <listitem>
460 <para>
461 describes the format and characteristics of an image file.
462 </para>
463 <indexterm zone="imagemagick identify">
464 <primary sortas="b-identify">identify</primary>
465 </indexterm>
466 </listitem>
467 </varlistentry>
468
469 <varlistentry id="import">
470 <term><command>import</command></term>
471 <listitem>
472 <para>
473 captures an X window.
474 </para>
475 <indexterm zone="imagemagick import">
476 <primary sortas="b-import">import</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 <varlistentry id="magick">
482 <term><command>magick</command></term>
483 <listitem>
484 <para>
485 convert between image formats as well as resize an image,
486 blur, crop, despeckle, dither, draw on, flip, join, re-sample
487 and much more.
488 </para>
489 <indexterm zone="imagemagick magick">
490 <primary sortas="b-magick">magick</primary>
491 </indexterm>
492 </listitem>
493 </varlistentry>
494
495 <varlistentry id="magick-config">
496 <term><command>Magick{++,Core,Wand}-config</command></term>
497 <listitem>
498 <para>
499 show information about the installed versions of the
500 <application>ImageMagick</application> libraries.
501 </para>
502 <indexterm zone="imagemagick magick-config">
503 <primary sortas="b-Magick-config">Magick-config</primary>
504 </indexterm>
505 </listitem>
506 </varlistentry>
507
508 <varlistentry id="mogrify">
509 <term><command>mogrify</command></term>
510 <listitem>
511 <para>
512 transforms an image.
513 </para>
514 <indexterm zone="imagemagick mogrify">
515 <primary sortas="b-mogrify">mogrify</primary>
516 </indexterm>
517 </listitem>
518 </varlistentry>
519
520 <varlistentry id="montage">
521 <term><command>montage</command></term>
522 <listitem>
523 <para>
524 composites various images into a new image.
525 </para>
526 <indexterm zone="imagemagick montage">
527 <primary sortas="b-montage">montage</primary>
528 </indexterm>
529 </listitem>
530 </varlistentry>
531
532 <varlistentry id="stream">
533 <term><command>stream</command></term>
534 <listitem>
535 <para>
536 streams one or more pixel components of an image or
537 portion of the image to your choice of storage formats.
538 </para>
539 <indexterm zone="imagemagick stream">
540 <primary sortas="b-stream">stream</primary>
541 </indexterm>
542 </listitem>
543 </varlistentry>
544
545 <varlistentry id="perlmagick">
546 <term><filename class='libraryfile'>Image::Magick</filename></term>
547 <listitem>
548 <para>
549 allows the reading, manipulation and writing of a large number of
550 image file formats using the <application>ImageMagick</application>
551 library. Run <command>make</command> in the
552 <filename class='directory'>PerlMagick/demo</filename> directory of
553 the package source tree after the package is installed to see a nice
554 demo of the module's capabilities.
555 </para>
556 <indexterm zone="imagemagick perlmagick">
557 <primary sortas="g-Image-Magick">Image::Magick</primary>
558 </indexterm>
559 </listitem>
560 </varlistentry>
561
562 <varlistentry id="libMagickCore-7.Q16HDRI">
563 <term><filename class="libraryfile">libMagickCore-7.Q16HDRI.so</filename></term>
564 <listitem>
565 <para>
566 provides the C API for ImageMagick.
567 </para>
568 <indexterm zone="imagemagick libMagickCore-7.Q16HDRI">
569 <primary sortas="c-libMagickCore-7.Q16HDRI">libMagickCore-7.Q16HDRI.so</primary>
570 </indexterm>
571 </listitem>
572 </varlistentry>
573
574 <varlistentry id="libMagickWand-7.Q16HDRI">
575 <term><filename class="libraryfile">libMagickWand-7.Q16HDRI.so</filename></term>
576 <listitem>
577 <para>
578 is the recommended C API for ImageMagick. Unlike the MagickCore API it
579 uses only a few opaque types.
580 </para>
581 <indexterm zone="imagemagick libMagickWand-7.Q16HDRI">
582 <primary sortas="c-libMagickWand-7.Q16HDRI">libMagickWand-7.Q16HDRI.so</primary>
583 </indexterm>
584 </listitem>
585 </varlistentry>
586
587 <varlistentry id="libMagickpp-7.Q16HDRI">
588 <term><filename class="libraryfile">libMagick++-7.Q16HDRI.so</filename></term>
589 <listitem>
590 <para>
591 provides the C++ API for ImageMagick.
592 </para>
593 <indexterm zone="imagemagick libMagickpp-7.Q16HDRI">
594 <primary sortas="c-libMagick++-7.Q16HDRI">libMagick++-7.Q16HDRI.so</primary>
595 </indexterm>
596 </listitem>
597 </varlistentry>
598
599 </variablelist>
600
601 </sect2>
602
603</sect1>
Note: See TracBrowser for help on using the repository browser.