source: general/genutils/imagemagick.xml@ ce80f45

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since ce80f45 was ce80f45, checked in by Ken Moffat <ken@…>, 2 years ago

ImageMagick updates for 9.0.

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

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