source: general/genutils/imagemagick.xml@ 5b117af

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 5b117af was 5b117af, checked in by Ken Moffat <ken@…>, 8 years ago

ImageMagick-6.9.3-5

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