source: general/genutils/imagemagick.xml@ b520295

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.9 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 b520295 was b520295, checked in by Fernando de Oliveira <fernando@…>, 8 years ago
  • Update to ImageMagick-6.9.3-0.
  • Update to xterm-322.

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