source: general/genutils/imagemagick.xml@ 7b2fed0f

11.0 11.1 11.2 11.3 12.0 12.1 12.2 gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 7b2fed0f was 7b2fed0f, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

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