source: general/genutils/imagemagick.xml@ e180a646

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since e180a646 was e180a646, checked in by Ken Moffat <ken@…>, 7 years ago

For a' that, an a' that,
It's coming yet for a' that,
That ilka body the world o'er,
Can use Guid Fonts for a' that.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18211 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 20.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 "3">
8
9 <!ENTITY imagemagick-download-http "https://www.imagemagick.org/download/releases/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz">
10 <!ENTITY imagemagick-download-ftp "ftp://ftp.imagemagick.org/pub/ImageMagick/releases/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz">
11 <!ENTITY imagemagick-md5sum "94ccdcf91ce0a156ca5335fbc16536b1">
12 <!ENTITY imagemagick-size "7.9 MB">
13 <!ENTITY imagemagick-buildsize "141 MB, with typical dependencies">
14 <!ENTITY imagemagick-time "2.6 SBU - typical build (add 1.1 SBU for the the validation suite)">
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 are installed, which is what we want.
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 Saved the "full" 450MB as a comment - feel free to update this iff you
28 do build all dependencies, it's probably a lot bigger now.
29
30 [bdubbs] Just removed it. I don't think it adds anything.
31
32 Also, please look over the output from the configure command for any
33 additional dependencies that need to be listed, as ImageMagick is
34 constantly adding additional features and dependencies.
35
36 For those of us who touch this infrequently:
37 DPS/dpsXclient is from apple so not relevant to linux builds
38 GVC is part of Graphviz and documented in the explanations
39 LQR is Liquid Rescale -->
40
41<sect1 id="imagemagick" xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
42 <?dbhtml filename="imagemagick.html"?>
43
44 <sect1info>
45 <othername>$LastChangedBy$</othername>
46 <date>$Date$</date>
47 </sect1info>
48
49 <title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
50
51 <indexterm zone="imagemagick">
52 <primary sortas="a-ImageMagick">ImageMagick</primary>
53 </indexterm>
54
55 <sect2 role="package">
56 <title>Introduction to ImageMagick</title>
57
58 <para>
59 <application>ImageMagick</application> is a collection of tools and
60 libraries to read, write, and manipulate an image in various image
61 formats. Image processing operations are available from the command line.
62 Bindings for Perl and C++ are also available.
63 </para>
64
65 &lfs7a_checked;
66
67 <bridgehead renderas="sect3">Package Information</bridgehead>
68 <itemizedlist spacing="compact">
69 <listitem>
70 <para>Download (HTTP): <ulink url="&imagemagick-download-http;"/></para>
71 </listitem>
72 <listitem>
73 <para>Download (FTP): <ulink url="&imagemagick-download-ftp;"/></para>
74 </listitem>
75 <listitem>
76 <para>Download MD5 sum: &imagemagick-md5sum;</para>
77 </listitem>
78 <listitem>
79 <para>Download size: &imagemagick-size;</para>
80 </listitem>
81 <listitem>
82 <para>Estimated disk space required: &imagemagick-buildsize;</para>
83 </listitem>
84 <listitem>
85 <para>Estimated build time: &imagemagick-time;</para>
86 </listitem>
87 </itemizedlist>
88
89 <note>
90 <para>
91 The <application>ImageMagick</application> source releases are updated
92 frequently and the version shown above may no longer be available from
93 the download locations. You can download a more recent version and use
94 the existing BLFS instructions to install it. Chances are that it will
95 work just fine, but this has not been tested by the BLFS team. If the
96 package version shown above is not available from the locations shown
97 above, or from the <filename class='directory'>legacy/</filename>
98 directory at <literal>ftp.ImageMagick.org/pub/ImageMagick</literal> you
99 can download it from the BLFS package server at Oregon State University:
100 <ulink url="ftp://ftp.osuosl.org/pub/blfs/conglomeration/ImageMagick/"/>.
101 </para>
102 </note>
103
104 <bridgehead renderas="sect3">ImageMagick Dependencies</bridgehead>
105
106 <bridgehead renderas="sect4">Recommended</bridgehead>
107 <para role="recommended">
108 <xref linkend="xorg7-lib"/>
109 </para>
110
111 <para>
112 The optional dependencies listed below should be installed if you need
113 support for the specific format or the conversion tool the dependency
114 provides. Many of the dependencies' capabilities and uses are described in
115 the <quote>MAGICK DELEGATES</quote> section of the
116 <filename>README.txt</filename> file located in the source tree.
117 Additional information about the dependencies can be found in the
118 <filename>Install-unix.txt</filename> file located in the source tree as
119 well as issuing the <command>./configure --help</command> command. A
120 summary of this information, as well as some additional notes can be
121 viewed on-line at <ulink
122 url="http://www.imagemagick.org/script/advanced-unix-installation.php"/>.
123 </para>
124
125 <bridgehead renderas="sect4">Optional System Utilities</bridgehead>
126 <para role="optional">
127 <xref linkend="cups"/>,
128 <xref linkend="curl"/>,
129 <xref linkend="ffmpeg"/>,
130 <xref linkend="p7zip"/> (LZMA),
131 <xref linkend="sane"/>,
132 <xref linkend="wget"/>,
133 <xref linkend="xdg-utils"/>,
134 <xref linkend="xterm2"/>,
135 <ulink url="http://dmalloc.com/">Dmalloc</ulink>,
136 <ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>,
137 <ulink url="http://www.fftw.org/">FFTW</ulink>,
138 <ulink url="http://www.openpgp.org/about/">PGP</ulink> or
139 <xref linkend="gnupg2"/>
140 (you'll have to do some hacking to use <application>GnuPG</application>),
141 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates">Profiles</ulink>,
142 and
143 <ulink url="http://ufraw.sourceforge.net/">ufraw</ulink> (for raw formats
144 listed in
145 <ulink url="http://imagemagick.org/script/formats.php">
146 http://www.imagemagick.org/www/formats.html</ulink>)
147 </para>
148
149 <bridgehead renderas="sect4">Optional Graphics Libraries</bridgehead>
150 <para role="optional">
151 <xref linkend="jasper"/>,
152 <xref linkend="lcms"/> or
153 <xref linkend="lcms2"/>,
154 <xref linkend="libexif"/>,
155 <xref linkend="libjpeg"/>,
156 <xref linkend="libpng"/>,
157 <xref linkend="librsvg"/>,
158 <xref linkend="libtiff"/>,
159 <xref linkend="libwebp"/>,
160 <xref linkend="openjpeg2"/>,
161 <xref linkend="pango"/>,
162 <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
163 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/">
164 FlashPIX (libfpx)</ulink>,
165 <ulink url="https://github.com/FLIF-hub/FLIF/releases">FLIF</ulink>,
166 <ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
167 <ulink url="&gnome-download-http;/libgxps/">libgxps</ulink>,
168 <ulink url="https://github.com/HOST-Oman/libraqm/">libraqm</ulink>,
169 <ulink url="http://liblqr.wikidot.com/en:download-page">Liquid Rescale</ulink>,
170 <ulink url="http://www.openexr.com/">OpenEXR</ulink>, and
171 <ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>
172 (or <ulink url="http://www.mcmurchy.com/ralcgm/ralcgm-3.51.tar.gz">ralcgm</ulink>)
173 </para>
174
175 <bridgehead renderas="sect4">Optional Graphics Utilities</bridgehead>
176 <para role="optional">
177 <xref linkend="dejavu-fonts"/>,
178 <xref linkend="gs"/>,
179 <xref linkend="gimp"/>,
180 <xref linkend="graphviz"/>,
181 <xref linkend="inkscape"/>,
182 <ulink url="http://www.blender.org/">Blender</ulink>,
183 <ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
184 <ulink url="http://www.ghostscript.com/download/gpcldnld.html">GhostPCL</ulink>,
185 <ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
186 <ulink url="http://www.povray.org/">POV-Ray</ulink>, and
187 <ulink url="http://www.radiance-online.org/">Radiance</ulink>
188 </para>
189
190 <bridgehead renderas="sect4">Optional Conversion Tools</bridgehead>
191 <para role="optional">
192 <xref linkend="enscript"/>,
193 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
194 <ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
195 <ulink url="http://www.lizardtech.com/downloads/category/">
196 GeoExpress Command Line Utilities, AKA MrSID Utilities (binary package)</ulink>,
197 <ulink url="http://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
198 <ulink url="http://user.it.uu.se/~jan/html2ps.html">html2ps</ulink>,
199 <ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
200 <ulink url="http://sk1project.org/modules.php?name=products&amp;product=uniconvertor">
201 UniConvertor</ulink>, and
202 <ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
203 (or <ulink url="http://www.mcmurchy.com/urt/urt-3.1b.tar.gz">URT-3.1b</ulink>)
204 </para>
205
206 <para condition="html" role="usernotes">User Notes:
207 <ulink url="&blfs-wiki;/imagemagick"/></para>
208
209 </sect2>
210
211 <sect2 role="installation">
212 <title>Installation of ImageMagick</title>
213
214 <para>
215 Install <application>ImageMagick</application> by running the following
216 commands:
217 </para>
218
219<screen><userinput>./configure --prefix=/usr \
220 --sysconfdir=/etc \
221 --enable-hdri \
222 --with-modules \
223 --with-perl \
224 --disable-static &amp;&amp;
225make</userinput></screen>
226
227 <para>
228 Now, as the <systemitem class="username">root</systemitem> user:
229 </para>
230
231<screen role="root"><userinput>make DOCUMENTATION_PATH=/usr/share/doc/imagemagick-&imagemagick-version; install</userinput></screen>
232
233 <para>
234 To test the installation, issue: <command>make check</command>. A more
235 comprehensive test is the <application>ImageMagick</application>
236 validation suite. If <command>make check</command> has not been executed,
237 run <command>make tests/validate</command> to compile it. Issue
238 <command>tests/validate 2>&amp;1 | tee validate.log</command> to run the
239 validation suite. The result summary may be obtained with <command>grep
240 "validation suite" validate.log</command>. Note that the EPS, PS, and PDF
241 tests require a working <application>Ghostscript</application>. One test
242 in 'make check' needs <quote>Helvetica</quote> from <quote>Ghostscript
243 Standard Fonts</quote>, which are optionally installed in
244 <xref linkend="gs"/> - that test, and one other, might fail, but all the
245 validation can still pass.
246 </para>
247
248 </sect2>
249
250 <sect2 role="commands">
251 <title>Command Explanations</title>
252
253 <para>
254 <parameter>--enable-hdri</parameter>: Enables building of a
255 high dynamic range version of ImageMagick.
256 </para>
257
258 <para>
259 <parameter>--with-modules</parameter>: Enables support for
260 dynamically loadable modules.
261 </para>
262
263 <para>
264 <parameter>--with-perl</parameter>: Enables building and
265 installing of PerlMagick.
266 </para>
267
268 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
269 href="../../xincludes/static-libraries.xml"/>
270
271 <para>
272 <option>--with-gslib</option>: Enables support to use the
273 <application>Ghostscript</application> shared library.
274 </para>
275
276 <para>
277 <option>--with-rsvg</option>: Enables support to use the
278 <application>librsvg</application> library.
279 </para>
280
281 <para>
282 <option>--with-autotrace</option>: Enables support to use
283 the <application>Autotrace</application> library.
284 </para>
285
286 <para>
287 <option>--with-wmf</option>: Enables support to use the
288 <application>libwmf</application> library.
289 </para>
290
291 <para>
292 <option>--with-gvc</option>: Enables support to use
293 <application>GraphViz</application>.
294 </para>
295
296 <para>
297 <option>--with-windows-font-dir=
298 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
299 This option specifies the directory where the Windows CoreFonts are
300 installed.
301 </para>
302
303 <para>
304 <option>--with-dejavu-font-dir=
305 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
306 This option specifies the directory where the DejaVu fonts are
307 installed.
308 </para>
309
310 <para>
311 The options and parameters listed above are the only ones you should
312 have to pass to the <command>configure</command> script to activate all
313 the delegate dependencies. All other dependencies will be automatically
314 detected and utilized in the build if they are installed.
315 </para>
316
317 </sect2>
318
319 <sect2 role="content">
320 <title>Contents</title>
321
322 <segmentedlist>
323 <segtitle>Installed Programs</segtitle>
324 <segtitle>Installed Libraries</segtitle>
325 <segtitle>Installed Directories</segtitle>
326
327 <seglistitem>
328 <seg>
329 magick, Magick++-config, MagickCore-config, and MagickWand-config.
330 (animate, compare, composite, conjure, convert, display,
331 identify, import, magick-script, mogrify, montage, and stream
332 are all symbolic links to magick)
333 </seg>
334 <seg>
335 libMagickCore-7.Q16HDRI.so,
336 libMagickWand-7.Q16HDRI.so and
337 libMagick++-7.Q16HDRI.so
338 </seg>
339 <seg>
340 /etc/ImageMagick-7,
341 /usr/include/ImageMagick-7,
342 /usr/lib/ImageMagick-&imagemagick-version;,
343 /usr/lib/perl5/site_perl/&lfs-perl-version;/$(uname -m)-linux/{,auto}/Image/Magick,
344 /usr/share/doc/ImageMagick-&imagemagick-version;, and
345 /usr/share/ImageMagick-7
346 </seg>
347 </seglistitem>
348 </segmentedlist>
349
350 <variablelist>
351 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
352 <?dbfo list-presentation="list"?>
353 <?dbhtml list-presentation="table"?>
354
355 <varlistentry id="animate">
356 <term><command>animate</command></term>
357 <listitem>
358 <para>animates a sequence of images.</para>
359 <indexterm zone="imagemagick animate">
360 <primary sortas="b-animate">animate</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="compare">
366 <term><command>compare</command></term>
367 <listitem>
368 <para>compares an image to a reconstructed image.</para>
369 <indexterm zone="imagemagick compare">
370 <primary sortas="b-compare">compare</primary>
371 </indexterm>
372 </listitem>
373 </varlistentry>
374
375 <varlistentry id="composite">
376 <term><command>composite</command></term>
377 <listitem>
378 <para>composites various images into the given base image.</para>
379 <indexterm zone="imagemagick composite">
380 <primary sortas="b-composite">composite</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 <varlistentry id="conjure">
386 <term><command>conjure</command></term>
387 <listitem>
388 <para>processes a MSL script to create an image.</para>
389 <indexterm zone="imagemagick conjure">
390 <primary sortas="b-conjure">conjure</primary>
391 </indexterm>
392 </listitem>
393 </varlistentry>
394
395 <varlistentry id="convert">
396 <term><command>convert</command></term>
397 <listitem>
398 <para>converts image(s) from one format to another.</para>
399 <indexterm zone="imagemagick convert">
400 <primary sortas="b-convert">convert</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="display">
406 <term><command>display</command></term>
407 <listitem>
408 <para>displays an image.</para>
409 <indexterm zone="imagemagick display">
410 <primary sortas="b-display">display</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="identify">
416 <term><command>identify</command></term>
417 <listitem>
418 <para>describes the format and characteristics of an image file.</para>
419 <indexterm zone="imagemagick identify">
420 <primary sortas="b-identify">identify</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="import">
426 <term><command>import</command></term>
427 <listitem>
428 <para>captures an X window.</para>
429 <indexterm zone="imagemagick import">
430 <primary sortas="b-import">import</primary>
431 </indexterm>
432 </listitem>
433 </varlistentry>
434
435 <varlistentry id="magick-config">
436 <term><command>Magick{++,Core,Wand}-config</command></term>
437 <listitem>
438 <para>show information about the installed versions of the
439 <application>ImageMagick</application> libraries.</para>
440 <indexterm zone="imagemagick magick-config">
441 <primary sortas="b-Magick-config">Magick-config</primary>
442 </indexterm>
443 </listitem>
444 </varlistentry>
445
446 <varlistentry id="mogrify">
447 <term><command>mogrify</command></term>
448 <listitem>
449 <para>transforms an image.</para>
450 <indexterm zone="imagemagick mogrify">
451 <primary sortas="b-mogrify">mogrify</primary>
452 </indexterm>
453 </listitem>
454 </varlistentry>
455
456 <varlistentry id="montage">
457 <term><command>montage</command></term>
458 <listitem>
459 <para>composites various images into a new image.</para>
460 <indexterm zone="imagemagick montage">
461 <primary sortas="b-montage">montage</primary>
462 </indexterm>
463 </listitem>
464 </varlistentry>
465
466 <varlistentry id="stream">
467 <term><command>stream</command></term>
468 <listitem>
469 <para>streams one or more pixel components of an image or
470 portion of the image to your choice of storage formats.</para>
471 <indexterm zone="imagemagick stream">
472 <primary sortas="b-stream">stream</primary>
473 </indexterm>
474 </listitem>
475 </varlistentry>
476
477 <!-- the following does not validate
478 <varlistentry id="perlmagick">
479 <term><filename class='libraryfile'>Image::Magick</filename></term>
480 <listitem>
481 <para>allows the reading, manipulation and writing of a large number of
482 image file formats using the <application>ImageMagick</application>
483 library. Run <command>make</command> in the
484 <filename class='directory'>PerlMagick/demo</filename> directory of
485 the package source tree after the package is installed to see a nice
486 demo of the module's capabilities.</para>
487 <indexterm zone="imagemagick perlmagick">
488 <primary sortas="g-Image-Magick">Image::Magick</primary>
489 </indexterm>
490 </listitem>
491 </varlistentry>
492
493 <varlistentry id="libMagickCore-7.Q16HDRI">
494 <term><filename class="libraryfile">libMagickCore-7.Q16HDRI.so</filename></term>
495 <listitem>
496 <para>
497 provides the C API for ImageMagick.
498 </para>
499 <indexterm zone="imagemagick libMagickCore-7.Q16HDRI">
500 <primary sortas="c-libMagickCore-7.Q16HDRI">libMagickCore-7.Q16HDRI.so</primary>
501 </indexterm>
502 </listitem>
503 </varlistentry>
504
505 <varlistentry id="libMagickWand-7.Q16HDRI">
506 <term><filename class="libraryfile">libMagickWand-7.Q16HDRI.so</filename></term>
507 <listitem>
508 <para>
509 is the recommended C API for ImageMagick. Unlike the MagickCore API it
510 uses only a few opaque types.
511 </para>
512 <indexterm zone="imagemagick libMagickWand-7.Q16HDRI">
513 <primary sortas="c-libMagickWand-7.Q16HDRI">libMagickWand-7.Q16HDRI.so</primary>
514 </indexterm>
515 </listitem>
516 </varlistentry>
517
518 <varlistentry id="libMagick++-7.Q16HDRI">
519 <term><filename class="libraryfile">libMagick++-7.Q16HDRI.so</filename></term>
520 <listitem>
521 <para>
522 provides the C++ API for ImageMagick.
523 </para>
524 <indexterm zone="imagemagick libMagick++-7.Q16HDRI">
525 <primary sortas="c-libMagick++-7.Q16HDRI">libMagick++-7.Q16HDRI.so</primary>
526 </indexterm>
527 </listitem>
528 </varlistentry> -->
529
530 </variablelist>
531
532 </sect2>
533
534</sect1>
Note: See TracBrowser for help on using the repository browser.