source: general/genutils/imagemagick.xml@ 363e081b

11.2 11.3 12.0 12.1 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 xry111/llvm18 xry111/soup3 xry111/xf86-video-removal
Last change on this file since 363e081b was 363e081b, checked in by Douglas R. Reno <renodr@…>, 20 months ago

Package updates:

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