source: general/genutils/imagemagick.xml@ 277c9f4e

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

Patch libxml2 and libexif.

Comment libexif as a possible ImageMagick dependency.

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

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