source: general/genutils/imagemagick.xml@ f14d3acd

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 f14d3acd was 28d1edf, checked in by Pierre Labastie <pierre.labastie@…>, 9 months ago

Remove a few forgotten ftp urls

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