source: general/genutils/imagemagick.xml@ a6d9935c

systemd-11177
Last change on this file since a6d9935c was fd968dd, checked in by Krejzi <krejzi@…>, 11 years ago

Drop pkg-config from systemd branch.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@11285 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 19.9 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 "6">
8 <!-- Not sure what to do here as ImageMagick is one of the fastest-moving
9 targets in all of open-source. One solution is to always use the last
10 version of a specific major-minor from the 'legacy' subdirectory of
11 the path in these URL's. Otherwise these links are broken within days
12 after updates :-( Unfortunately, versions always roll on after patch
13 version 10, whether or not significant changes occur, and it takes
14 time before versions migrate to legacy/ -->
15
16 <!ENTITY imagemagick-download-http " ">
17 <!ENTITY imagemagick-download-ftp "ftp://ftp.imagemagick.org/pub/ImageMagick/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz">
18 <!ENTITY imagemagick-md5sum "d2d03e8131722a5b85fc2a866d9df517">
19 <!ENTITY imagemagick-size "7.9 MB">
20 <!ENTITY imagemagick-buildsize "208 MB (with typical dependencies, reputedly 450 MB with all dependencies)">
21 <!ENTITY imagemagick-time "1.9 SBU (typical build - additional 20 SBU to run the test suite)">
22]>
23
24<!-- Editors: It is highly unlikely that the buildsize (disk space used) will
25 be less than the figure shown above. Unless you have installed *all* the
26 delegate dependencies, you will see a smaller buildsize, but what is
27 currently listed above is the space one would require if all the
28 dependencies are installed, which is what we want.
29
30 Marked as 'typical' because nobody builds ALL the optional extras [ken]
31 Saved the "full" 450MB as a comment - feel free to update this iff you
32 do build all dependencies, it's probably a lot bigger now.
33
34 Also, please look over the output from the configure command for any
35 additional dependencies that need to be listed, as ImageMagick is
36 constantly adding additional features and dependencies. -->
37
38
39<sect1 id="imagemagick"
40xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
41 <?dbhtml filename="imagemagick.html"?>
42
43 <sect1info>
44 <othername>$LastChangedBy$</othername>
45 <date>$Date$</date>
46 </sect1info>
47
48 <title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
49
50 <indexterm zone="imagemagick">
51 <primary sortas="a-ImageMagick">ImageMagick</primary>
52 </indexterm>
53
54 <sect2 role="package">
55 <title>Introduction to ImageMagick</title>
56
57 <para>
58 <application>ImageMagick</application> is a collection of tools and
59 libraries to read, write, and manipulate an image in various image formats.
60 Image processing operations are available from the command line. Bindings
61 for Perl and C++ are also available.
62 </para>
63
64 &lfs73_checked;
65
66 <bridgehead renderas="sect3">Package Information</bridgehead>
67 <itemizedlist spacing="compact">
68 <listitem>
69 <para>Download (HTTP): <ulink url="&imagemagick-download-http;"/></para>
70 </listitem>
71 <listitem>
72 <para>Download (FTP): <ulink url="&imagemagick-download-ftp;"/></para>
73 </listitem>
74 <listitem>
75 <para>Download MD5 sum: &imagemagick-md5sum;</para>
76 </listitem>
77 <listitem>
78 <para>Download size: &imagemagick-size;</para>
79 </listitem>
80 <listitem>
81 <para>Estimated disk space required: &imagemagick-buildsize;</para>
82 </listitem>
83 <listitem>
84 <para>Estimated build time: &imagemagick-time;</para>
85 </listitem>
86 </itemizedlist>
87
88 <note>
89 <para>
90 The <application>ImageMagick</application> source releases are
91 updated frequently and the version shown above may no longer be available
92 from the download locations. You can download a more recent version and use
93 the existing BLFS instructions to install it. Chances are that it will
94 work just fine, but this has not been tested by the BLFS team. If the
95 package version shown above is not available from the locations shown
96 above, or from the <filename class='directory'>legacy/</filename> directory
97 at <literal>ftp.ImageMagick.org/pub/ImageMagick</literal> you can download it
98 from the BLFS package server at <ulink
99 url="&sources-anduin-http;/i/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz"/>.
100 </para>
101 </note>
102
103 <bridgehead renderas="sect3">ImageMagick Dependencies</bridgehead>
104
105 <bridgehead renderas="sect4">Recommended</bridgehead>
106 <para role="recommended">
107 <xref linkend="x-window-system"/>
108 </para>
109
110 <para>
111 The optional dependencies listed below should be installed if you
112 need support for the specific format or the conversion tool the dependency
113 provides. Many of the dependencies' capabilities and uses are described in
114 the <quote>MAGICK DELEGATES</quote> section of the
115 <filename>README.txt</filename> file located in the source tree. Additional
116 information about the dependencies can be found in the
117 <filename>Install-unix.txt</filename> file located in the source tree as
118 well as issuing the <command>./configure --help</command> command. A
119 summary of this information, as well as some additional notes can be viewed
120 on-line at <ulink
121 url="http://www.imagemagick.org/script/advanced-unix-installation.php"/>.
122 </para>
123
124 <bridgehead renderas="sect4">Optional System Utilities</bridgehead>
125 <para role="optional">
126 <xref linkend="cups"/>,
127 <xref linkend="curl"/>,
128 <ulink url="http://dmalloc.com/">Dmalloc</ulink>,
129 <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink>,
130 <xref linkend="ffmpeg"/>,
131 <ulink url="http://www.fftw.org/">FFTW</ulink>,
132 <ulink url="http://www.gsp.com/support/virtual/email/pgp/">PGP</ulink>
133 or <xref linkend="gnupg"/> or <xref linkend="gnupg2"/>
134 (you'll have to do some hacking to use <application>GnuPG</application>),
135 <xref linkend="sane"/>,
136 <ulink url="http://ufraw.sourceforge.net/">ufraw</ulink> (for raw formats listed in
137 <filename>www/formats.html</filename>),
138 <xref linkend="wget"/>, and
139 <xref linkend="xdg-utils"/>
140 </para>
141
142 <bridgehead renderas="sect4">Optional Graphics Libraries</bridgehead>
143 <para role="optional">
144 <ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
145 <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
146 <!-- <ulink url="http://www.i3a.org/i_flashpix.html">FlashPIX</ulink> (or -->
147 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/libfpx-1.3.1-2.tar.bz2">
148 FlashPIX</ulink>,
149 <!-- Added already from the Xorg recommended dependency <xref linkend="freetype2"/>, -->
150 <xref linkend="jasper"/>,
151 <ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
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 <ulink url="http://www.webmproject.org/code/">libwebp</ulink>,
160 <ulink url="http://liblqr.wikidot.com/en:download-page">Liquid Rescale</ulink>,
161 <ulink url="http://www.openexr.com/">OpenEXR</ulink>,
162 <xref linkend="pango"/>, and
163 <ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>
164 (or <ulink url="http://www.mcmurchy.com/ralcgm/ralcgm-3.51.tar.gz">ralcgm</ulink>)
165 </para>
166
167 <bridgehead renderas="sect4">Optional Graphics Utilities</bridgehead>
168 <para role="optional">
169 <ulink url="http://www.blender.org/">Blender</ulink>,
170 <ulink url="http://dejavu.sourceforge.net/">DejaVu fonts</ulink>,
171 <ulink url="http://www.artifex.com/downloads/">GhostPCL</ulink> or
172 <ulink url="http://www.ghostscript.com/GhostPCL.html">GhostPDL</ulink>,
173 <xref linkend="gs"/>,
174 <xref linkend="gimp"/>,
175 <ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
176 <xref linkend="graphviz"/>,
177 <xref linkend="inkscape"/>,
178 <ulink url="http://www.povray.org/">POV-Ray</ulink>, and
179 <ulink url="http://radsite.lbl.gov/radiance/HOME.html">Radiance</ulink>
180 </para>
181
182 <bridgehead renderas="sect4">Optional Conversion Tools</bridgehead>
183 <para role="optional">
184 <ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
185 <xref linkend="enscript"/>,
186 <ulink url="http://www.lizardtech.com/downloads/category/">
187 GeoExpress Command Line Utilities, AKA MrSID Utilities (binary package)</ulink>,
188 <ulink url="http://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
189 <ulink url="http://user.it.uu.se/~jan/html2ps.html">html2ps</ulink>,
190 <ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
191 <ulink url="http://www.mpeg.org/MSSG/">MPEG-2 Video Codec</ulink>,
192 <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>,
193 <xref linkend="texlive"/>,
194 <ulink url="http://www.xfig.org/">Transfig</ulink>,
195 <!-- <ulink url="http://txt2html.sourceforge.net/">txt2html</ulink>
196 (requires Perl Module
197 <ulink url="http://cpan.org/authors/id/J/JS/JSTENZEL/Getopt-ArgvFile-1.11.tar.gz">
198 Getopt::ArgvFile</ulink>), and -->
199 <ulink url="http://sk1project.org/modules.php?name=products&amp;product=uniconvertor">
200 UniConvertor</ulink>, and
201 <ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
202 (or <ulink url="http://www.mcmurchy.com/urt/urt-3.1b.tar.gz">URT-3.1b</ulink>)
203 </para>
204
205 <para condition="html" role="usernotes">User Notes:
206 <ulink url="&blfs-wiki;/imagemagick"/></para>
207
208 </sect2>
209
210 <sect2 role="installation">
211 <title>Installation of ImageMagick</title>
212
213 <para>
214 Install <application>Imagemagick</application> by running the following commands:
215 </para>
216
217<screen><userinput>./configure --prefix=/usr \
218 --sysconfdir=/etc \
219 --with-modules \
220 --with-perl \
221 --disable-static &amp;&amp;
222make</userinput></screen>
223
224 <para>
225 The validation suite is intended to be run after the package is installed.
226 </para>
227
228 <para>
229 Now, as the <systemitem class="username">root</systemitem> user:
230 </para>
231
232<screen role="root"><userinput>make install</userinput></screen>
233
234 <para>
235 To test the installation, issue: <command>make check</command>. Note that the
236 EPS, PS, and PDF tests require a working <application>Ghostscript</application>.
237 </para>
238
239 <!-- This is not necessary as the 'make install' process installs PerlMagick
240 <para>
241 And, if you built PerlMagick, still as the
242 <systemitem class="username">root</systemitem> user:</para>
243
244<screen role="root"><userinput>make -C PerlMagick install</userinput></screen>
245 -->
246
247 <!-- Commenting this out for now as it is redundant to information
248 that has already been presented, or is in the 'command explanations'
249 section below.
250 <sect3>
251 <title>Additional Configure Options</title>
252
253 <para>There are additional switches that can be passed to
254 <application>ImageMagick</application> to customize the installation to
255 your needs. See <filename>advanced-unix-installation.html</filename> in
256 the <filename class='directory'>www</filename> directory.</para>
257
258 </sect3>
259 -->
260
261 </sect2>
262
263 <sect2 role="commands">
264 <title>Command Explanations</title>
265
266 <para>
267 <parameter>--sysconfdir=/etc</parameter>: Install the
268 <filename class="extension">.xml</filename> configuration files into
269 <filename class='directory'>/etc/ImageMagick</filename> instead of the
270 default <filename class='directory'>/usr/etc/ImageMagick</filename>.
271 </para>
272
273 <para>
274 <parameter>--with-modules</parameter>: Enables support for dynamically
275 loadable modules.
276 </para>
277
278 <para>
279 <parameter>--with-perl</parameter>: Enables building and installing
280 PerlMagick.
281 </para>
282
283 <para>
284 <parameter>--disable-static</parameter>: Prevents the static
285 libraries being built and installed.
286 </para>
287
288 <!-- The tests run fine if you run the validation suite after the package
289 is installed
290 <para>
291 <parameter>-without-magick-plus-plus</parameter>: Disables building
292 and installing Magick++. All the test modules and demos for Magick++
293 currently fail.
294 </para>
295 -->
296
297 <para>
298 <option>--with-gslib=/usr/lib</option>: Enables support to use the
299 <application>Ghostscript</application> shared library.
300 </para>
301
302 <para>
303 <option>--with-rsvg</option>: Enables support to use the
304 <application>librsvg</application> library.
305 </para>
306
307 <para>
308 <option>--with-autotrace</option>: Enables support to use the
309 <application>Autotrace</application> library.
310 </para>
311
312 <para>
313 <option>--with-wmf</option>: Enables support to use the
314 <application>libwmf</application> library.
315 </para>
316
317 <para>
318 <option>--with-gvc</option>: Enables support to use
319 <application>GraphViz</application>.
320 </para>
321
322 <para>
323 <option>--with-windows-font-dir=
324 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
325 This option specifies the directory where the Windows CoreFonts are
326 installed.
327 </para>
328
329 <para>
330 <option>--with-dejavu-font-dir=
331 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
332 This option specifies the directory where the DejaVu fonts are
333 installed.
334 </para>
335
336 <para>
337 The options and parameters listed above are the only ones you should
338 have to pass to the <command>configure</command> script to activate all
339 the delegate dependencies. All other dependencies will be automatically
340 detected and utilized in the build if they are installed.
341 </para>
342
343 </sect2>
344
345 <sect2 role="content">
346 <title>Contents</title>
347
348 <segmentedlist>
349 <segtitle>Installed Programs</segtitle>
350 <segtitle>Installed Libraries</segtitle>
351 <segtitle>Installed Directories</segtitle>
352
353 <seglistitem>
354 <seg>animate, compare, composite, conjure, convert, display,
355 identify, import, Magick-config, Magic++-config, MagickCore-config,
356 MagickWand-config, mogrify, montage, stream, and Wand-config</seg>
357
358 <seg>libMagickCore-Q16.so, libMagickWand-Q16.so, libMagick++-Q16.so,
359 and numerous plugin modules</seg>
360
361 <seg>/etc/ImageMagick,
362 /usr/include/ImageMagick,
363 /usr/lib/ImageMagick-&imagemagick-version;,
364 /usr/lib/perl5/site_perl/&lfs-perl-version;/auto/Image,
365 /usr/lib/perl5/site_perl/&lfs-perl-version;/Image/Magick,
366 /usr/share/ImageMagick-&imagemagick-version; and
367 /usr/share/doc/ImageMagick-&imagemagick-version;</seg>
368 </seglistitem>
369 </segmentedlist>
370
371 <variablelist>
372 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
373 <?dbfo list-presentation="list"?>
374 <?dbhtml list-presentation="table"?>
375
376 <varlistentry id="animate">
377 <term><command>animate</command></term>
378 <listitem>
379 <para>animates a sequence of images.</para>
380 <indexterm zone="imagemagick animate">
381 <primary sortas="b-animate">animate</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="compare">
387 <term><command>compare</command></term>
388 <listitem>
389 <para>compares an image to a reconstructed image.</para>
390 <indexterm zone="imagemagick compare">
391 <primary sortas="b-compare">compare</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="composite">
397 <term><command>composite</command></term>
398 <listitem>
399 <para>composites various images into the given base image.</para>
400 <indexterm zone="imagemagick composite">
401 <primary sortas="b-composite">composite</primary>
402 </indexterm>
403 </listitem>
404 </varlistentry>
405
406 <varlistentry id="conjure">
407 <term><command>conjure</command></term>
408 <listitem>
409 <para>processes a MSL script to create an image.</para>
410 <indexterm zone="imagemagick conjure">
411 <primary sortas="b-conjure">conjure</primary>
412 </indexterm>
413 </listitem>
414 </varlistentry>
415
416 <varlistentry id="convert">
417 <term><command>convert</command></term>
418 <listitem>
419 <para>converts image(s) from one format to another.</para>
420 <indexterm zone="imagemagick convert">
421 <primary sortas="b-convert">convert</primary>
422 </indexterm>
423 </listitem>
424 </varlistentry>
425
426 <varlistentry id="display">
427 <term><command>display</command></term>
428 <listitem>
429 <para>displays an image.</para>
430 <indexterm zone="imagemagick display">
431 <primary sortas="b-display">display</primary>
432 </indexterm>
433 </listitem>
434 </varlistentry>
435
436 <varlistentry id="identify">
437 <term><command>identify</command></term>
438 <listitem>
439 <para>describes the format and characteristics of an image file.</para>
440 <indexterm zone="imagemagick identify">
441 <primary sortas="b-identify">identify</primary>
442 </indexterm>
443 </listitem>
444 </varlistentry>
445
446 <varlistentry id="import">
447 <term><command>import</command></term>
448 <listitem>
449 <para>captures an X window.</para>
450 <indexterm zone="imagemagick import">
451 <primary sortas="b-import">import</primary>
452 </indexterm>
453 </listitem>
454 </varlistentry>
455
456 <varlistentry id="magick-config">
457 <term><command>Magick{,++,Core,Wand}-config</command></term>
458 <listitem>
459 <para>show information about the installed versions of the
460 <application>ImageMagick</application> libraries.</para>
461 <indexterm zone="imagemagick magick-config">
462 <primary sortas="b-Magick-config">Magick-config</primary>
463 </indexterm>
464 </listitem>
465 </varlistentry>
466
467 <varlistentry id="mogrify">
468 <term><command>mogrify</command></term>
469 <listitem>
470 <para>transforms an image.</para>
471 <indexterm zone="imagemagick mogrify">
472 <primary sortas="b-mogrify">mogrify</primary>
473 </indexterm>
474 </listitem>
475 </varlistentry>
476
477 <varlistentry id="montage">
478 <term><command>montage</command></term>
479 <listitem>
480 <para>composites various images into a new image.</para>
481 <indexterm zone="imagemagick montage">
482 <primary sortas="b-montage">montage</primary>
483 </indexterm>
484 </listitem>
485 </varlistentry>
486
487 <varlistentry id="stream">
488 <term><command>stream</command></term>
489 <listitem>
490 <para>streams one or more pixel components of an image or
491 portion of the image to your choice of storage formats.</para>
492 <indexterm zone="imagemagick stream">
493 <primary sortas="b-stream">stream</primary>
494 </indexterm>
495 </listitem>
496 </varlistentry>
497
498 <varlistentry id="wand-config">
499 <term><command>Wand-config</command></term>
500 <listitem>
501 <para>shows the options required to use the Wand library.</para>
502 <indexterm zone="imagemagick wand-config">
503 <primary sortas="b-Wand-config">Wand-config</primary>
504 </indexterm>
505 </listitem>
506 </varlistentry>
507
508 <varlistentry id="perlmagick">
509 <term><filename class='libraryfile'>Image::Magick</filename></term>
510 <listitem>
511 <para>allows the reading, manipulation and writing of a large number of
512 image file formats using the <application>ImageMagick</application>
513 library. Run <command>make</command> in the
514 <filename class='directory'>PerlMagick/demo</filename> directory of
515 the package source tree after the package is installed to see a nice
516 demo of the module's capabilities.</para>
517 <indexterm zone="imagemagick perlmagick">
518 <primary sortas="g-Image-Magick">Image::Magick</primary>
519 </indexterm>
520 </listitem>
521 </varlistentry>
522
523 </variablelist>
524
525 </sect2>
526
527</sect1>
Note: See TracBrowser for help on using the repository browser.