source: general/genutils/imagemagick.xml@ 4b694302

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 nosym 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 4b694302 was 4b694302, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to ImageMagick-7.0.1-2.
Update to vala-0.32.0.

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