source: general/genutils/imagemagick.xml@ f3fc117

12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since f3fc117 was c0d29264, checked in by Bruce Dubbs <bdubbs@…>, 11 months ago

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