source: general/genutils/imagemagick.xml@ 8aeb474

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 8aeb474 was 8aeb474, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

General cleanup. Mostly removing obsolete comments.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10680 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 17.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 "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 "1dc4fb3febd1db7e0ab47c877f66eb09">
19 <!ENTITY imagemagick-size "7.5 MB">
20 <!ENTITY imagemagick-buildsize "264 MB typical (additional 27MB if you run the testsuite, and additional 68 MB if you run the Image::Magick demo)">
21 <!ENTITY imagemagick-time "3.2 SBU typical (Additional 0.8 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
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
37<sect1 id="imagemagick"
38xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
39 <?dbhtml filename="imagemagick.html"?>
40
41 <sect1info>
42 <othername>$LastChangedBy$</othername>
43 <date>$Date$</date>
44 </sect1info>
45
46 <title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
47
48 <indexterm zone="imagemagick">
49 <primary sortas="a-ImageMagick">ImageMagick</primary>
50 </indexterm>
51
52 <sect2 role="package">
53 <title>Introduction to ImageMagick</title>
54
55 <para><application>ImageMagick</application> is a collection of tools and
56 libraries to read, write, and manipulate an image in various image formats.
57 Image processing operations are available from the command line. Bindings
58 to various programming languages are also available.</para>
59
60 &lfs72_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><para>The <application>ImageMagick</application> source releases are
85 updated frequently and the version shown above may no longer be available
86 from the download locations. You can download a more recent version and use
87 the existing BLFS instructions to install it. Chances are that it will
88 work just fine, but this has not been tested by the BLFS team. If the
89 package version shown above is not available from the locations shown
90 above, or from the <filename class='directory'>legacy/</filename> directory
91 at <literal>ftp.ImageMagick.org/pub/ImageMagick</literal> you can download it
92 from the BLFS package server at
93 <ulink
94 url="&sources-anduin-http;/i/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz"/>.
95 </para></note>
96
97 <bridgehead renderas="sect3">ImageMagick Dependencies</bridgehead>
98
99 <bridgehead renderas="sect4">Recommended</bridgehead>
100 <para role="recommended"><xref linkend="x-window-system"/></para>
101
102 <para>The optional dependencies listed below should be installed if you
103 need 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. Additional
107 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 viewed
111 on-line at <ulink
112 url="http://www.imagemagick.org/script/advanced-unix-installation.php"/>.</para>
113
114 <bridgehead renderas="sect4">Optional System Utilities</bridgehead>
115 <para role="optional"><xref linkend="pkgconfig"/>,
116 <xref linkend="cups"/> or <xref linkend="LPRng"/> (or any other print
117 utility that provides an <command>lpr</command> command),
118 <ulink url="http://ufraw.sourceforge.net/">ufraw</ulink> (only for raw formats listed in
119 <filename>www/formats.html</filename>),
120 <ulink url="http://dmalloc.com/">Dmalloc</ulink>,
121 <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink>,
122 <ulink url="http://www.gsp.com/support/virtual/email/pgp/">PGP</ulink>
123 or <xref linkend="gnupg"/> or <xref linkend="gnupg2"/>
124 (you'll have to do some hacking to use <application>GnuPG</application>),
125 <xref linkend="sane"/>, and
126 <xref linkend="wget"/>
127 </para>
128
129 <bridgehead renderas="sect4">Optional Graphics Libraries</bridgehead>
130 <para role="optional"><ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
131 <ulink url="http://www.i3a.org/i_flashpix.html">FlashPIX</ulink> (or
132 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/libfpx-1.3.0-1.tar.bz2">
133 FlashPIX library</ulink>),
134 <xref linkend="freetype2"/>,
135 <xref linkend="jasper"/>,
136 <ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
137 <xref linkend="lcms"/> or
138 <ulink url="http://sourceforge.net/projects/lcms/files/">lcms2</ulink>,
139 <xref linkend="libexif"/>,
140 <xref linkend="libjpeg"/>,
141 <xref linkend="libpng"/>,
142 <xref linkend="librsvg"/>,
143 <xref linkend="libtiff"/>,
144 <xref linkend="pango"/>,
145 <ulink url="http://www.webmproject.org/code/">libwebp</ulink>, and
146 <xref linkend="libxml2"/>,
147 <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>, and
148 <ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>
149 </para>
150
151 <bridgehead renderas="sect4">Optional Graphics Utilities</bridgehead>
152 <para role="optional"><!-- <xref linkend="espgs"/> or --><xref linkend="gs"/>,
153 <ulink url="http://www.artifex.com/downloads/">GhostPCL</ulink>,
154 <xref linkend="gimp"/>,
155 <ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
156 <xref linkend="graphviz"/>,
157 <ulink url="http://www.povray.org/">POV-Ray</ulink>, and
158 <ulink url="http://radsite.lbl.gov/radiance/HOME.html">Radiance</ulink>
159 </para>
160
161 <bridgehead renderas="sect4">Optional Conversion Tools</bridgehead>
162 <para role="optional"><ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
163 <xref linkend="enscript"/>,
164 <ulink url="http://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
165 <ulink url="http://user.it.uu.se/~jan/html2ps.html">html2ps</ulink>,
166 <ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
167 <ulink url="http://www.mpeg.org/MSSG/">MPEG-2 Video Codec</ulink>,
168 <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>,
169 <xref linkend="texlive"/>,
170 <ulink url="http://www.xfig.org/">Transfig</ulink>,
171 <ulink url="http://txt2html.sourceforge.net/">txt2html</ulink>
172 (requires Perl Module
173 <ulink url="http://cpan.org/authors/id/J/JS/JSTENZEL/Getopt-ArgvFile-1.11.tar.gz">
174 Getopt::ArgvFile</ulink>), and
175 <ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
176 (or <ulink url="http://www.mcmurchy.com/urt/urt-3.1b.tar.gz">URT-3.1b</ulink>)
177 </para>
178
179 <para condition="html" role="usernotes">User Notes:
180 <ulink url="&blfs-wiki;/imagemagick"/></para>
181
182 </sect2>
183
184 <sect2 role="installation">
185 <title>Installation of ImageMagick</title>
186
187 <para>Install <application>Imagemagick</application> by running the following
188 commands:</para>
189
190<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
191 --with-modules &amp;&amp;
192make</userinput></screen>
193
194 <para>If you wish to build the <application>PerlMagick</application>
195 <application>perl</application> module, use the following commands:</para>
196
197<screen><userinput>cd PerlMagick &amp;&amp;
198perl Makefile.PL &amp;&amp;
199make &amp;&amp;
200cd ..</userinput></screen>
201
202 <para>To test the results, issue: <command>make check</command>. Note that
203 many of the tests require a working <application>ghostscript</application>.</para>
204
205 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
206
207<screen role="root"><userinput>make install</userinput></screen>
208
209 <para>And, if you built PerlMagick, still as the
210 <systemitem class="username">root</systemitem> user:</para>
211
212<screen role="root"><userinput>make -C PerlMagick install</userinput></screen>
213
214 <!-- Commenting this out for now as it is redundant to information
215 that has already been presented, or is in the 'command explanations'
216 section below.
217 <sect3>
218 <title>Additional Configure Options</title>
219
220 <para>There are additional switches that can be passed to
221 <application>ImageMagick</application> to customize the installation to
222 your needs. See <filename>advanced-unix-installation.html</filename> in
223 the <filename class='directory'>www</filename> directory.</para>
224
225 </sect3>
226 -->
227
228 </sect2>
229
230 <sect2 role="commands">
231 <title>Command Explanations</title>
232
233 <para><parameter>--sysconfdir=/etc</parameter>: Put the directory of xml (and
234 .icc) files at <filename class='directory'>/etc/ImageMagick</filename> instead of
235 <filename class='directory'>/usr/etc/ImageMagick</filename>.</para>
236
237 <para><parameter>--with-modules</parameter>: Enables support for dynamically
238 loadable modules.</para>
239
240 <para><option>--with-gslib=/usr/lib</option>: Enables support to use the
241 Ghostscript shared library.</para>
242
243 <para><option>--with-fpx</option>: Enables support to use the FlashPix
244 library.</para>
245
246 <para><option>--with-windows-font-dir=<replaceable>&lt;Some/Directory&gt;</replaceable></option>:
247 This option specifies the directory where the Windows CoreFonts are
248 installed.</para>
249
250 <para>The options and parameters listed above are the only ones you should
251 have to pass to the <command>configure</command> script to activate all the
252 delegate dependencies. All other dependencies will be automatically
253 detected and utilized in the build if they are installed.</para>
254
255 <para><option>--disable-static</option>: This switch prevents
256 the static libraries being built.</para>
257
258 </sect2>
259
260 <sect2 role="content">
261 <title>Contents</title>
262
263 <segmentedlist>
264 <segtitle>Installed Programs</segtitle>
265 <segtitle>Installed Libraries</segtitle>
266 <segtitle>Installed Directories</segtitle>
267
268 <seglistitem>
269 <seg>animate, compare, composite, conjure, convert, display,
270 identify, import, Magick++-config, Magick-config, MagickCore-config,
271 MagickWand-config, mogrify, montage, stream, and Wand-config</seg>
272 <seg>libMagick.{so,a}, libMagickCore.{so,a} libMagick++.{so,a},
273 libMagickWand.{so,a}, optionally the Magick.so Perl module, and
274 numerous plugin modules</seg>
275 <seg>/usr/include/Magick++, /usr/include/magick, /usr/include/wand,
276 /usr/lib/ImageMagick-&imagemagick-version;,
277 /usr/lib/perl5/site_perl/&lfs-perl-version;/auto/Image,
278 /usr/lib/perl5/site_perl/&lfs-perl-version;/Image/Magick,
279 /usr/share/ImageMagick-&imagemagick-version; and
280 /usr/share/doc/ImageMagick-&imagemagick-version;</seg>
281 </seglistitem>
282 </segmentedlist>
283
284 <variablelist>
285 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
286 <?dbfo list-presentation="list"?>
287 <?dbhtml list-presentation="table"?>
288
289 <varlistentry id="animate">
290 <term><command>animate</command></term>
291 <listitem>
292 <para>animates a sequence of images.</para>
293 <indexterm zone="imagemagick animate">
294 <primary sortas="b-animate">animate</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 <varlistentry id="compare">
300 <term><command>compare</command></term>
301 <listitem>
302 <para>compares an image to a reconstructed image.</para>
303 <indexterm zone="imagemagick compare">
304 <primary sortas="b-compare">compare</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="composite">
310 <term><command>composite</command></term>
311 <listitem>
312 <para>composites various images into the given base image.</para>
313 <indexterm zone="imagemagick composite">
314 <primary sortas="b-composite">composite</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 <varlistentry id="conjure">
320 <term><command>conjure</command></term>
321 <listitem>
322 <para>processes a MSL script to create an image.</para>
323 <indexterm zone="imagemagick conjure">
324 <primary sortas="b-conjure">conjure</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328
329 <varlistentry id="convert">
330 <term><command>convert</command></term>
331 <listitem>
332 <para>converts image(s) from one format to another.</para>
333 <indexterm zone="imagemagick convert">
334 <primary sortas="b-convert">convert</primary>
335 </indexterm>
336 </listitem>
337 </varlistentry>
338
339 <varlistentry id="display">
340 <term><command>display</command></term>
341 <listitem>
342 <para>displays an image.</para>
343 <indexterm zone="imagemagick display">
344 <primary sortas="b-display">display</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="identify">
350 <term><command>identify</command></term>
351 <listitem>
352 <para>describes the format and characteristics of an image file.</para>
353 <indexterm zone="imagemagick identify">
354 <primary sortas="b-identify">identify</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="import">
360 <term><command>import</command></term>
361 <listitem>
362 <para>captures an X window.</para>
363 <indexterm zone="imagemagick import">
364 <primary sortas="b-import">import</primary>
365 </indexterm>
366 </listitem>
367 </varlistentry>
368
369 <varlistentry id="magick-config">
370 <term><command>Magick-config</command> and
371 <command>Magick++-config, MagickCore-config, MagickWand-config</command></term>
372 <listitem>
373 <para>show information about the installed versions of the
374 <application>ImageMagick</application> Magick++, MagickCore and MagickWand libraries.</para>
375 <indexterm zone="imagemagick magick-config">
376 <primary sortas="b-Magick-config">Magick-config</primary>
377 </indexterm>
378 </listitem>
379 </varlistentry>
380
381 <varlistentry id="mogrify">
382 <term><command>mogrify</command></term>
383 <listitem>
384 <para>transforms an image.</para>
385 <indexterm zone="imagemagick mogrify">
386 <primary sortas="b-mogrify">mogrify</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="montage">
392 <term><command>montage</command></term>
393 <listitem>
394 <para>composites various images into a new image.</para>
395 <indexterm zone="imagemagick montage">
396 <primary sortas="b-montage">montage</primary>
397 </indexterm>
398 </listitem>
399 </varlistentry>
400
401 <varlistentry id="stream">
402 <term><command>stream</command></term>
403 <listitem>
404 <para>streams one or more pixel components of an image or
405 portion of the image to your choice of storage formats.</para>
406 <indexterm zone="imagemagick stream">
407 <primary sortas="b-stream">stream</primary>
408 </indexterm>
409 </listitem>
410 </varlistentry>
411
412 <varlistentry id="wand-config">
413 <term><command>Wand-config</command></term>
414 <listitem>
415 <para>shows the options required to use the Wand library.</para>
416 <indexterm zone="imagemagick wand-config">
417 <primary sortas="b-Wand-config">Wand-config</primary>
418 </indexterm>
419 </listitem>
420 </varlistentry>
421
422 <varlistentry id="perlmagick">
423 <term><filename class='libraryfile'>Image::Magick</filename></term>
424 <listitem>
425 <para>allows the reading, manipulation and writing of a large number of
426 image file formats using the <application>ImageMagick</application>
427 library. Run <command>make</command> in the
428 <filename class='directory'>PerlMagick/demo</filename> directory of
429 the package source tree after the package is installed to see a nice
430 demo of the module's capabilities.</para>
431 <indexterm zone="imagemagick perlmagick">
432 <primary sortas="g-Image-Magick">Image::Magick</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 </variablelist>
438
439 </sect2>
440
441</sect1>
Note: See TracBrowser for help on using the repository browser.