source: general/genutils/imagemagick.xml@ 17aa21c

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 17aa21c was 17aa21c, checked in by Xi Ruoyao <xry111@…>, 15 months ago

Change all ​http://*.sourceforge.net/ URLs to https

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