source: general/genutils/imagemagick.xml@ 3fa825f6

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 3fa825f6 was 3fa825f6, checked in by Ken Moffat <ken@…>, 10 years ago

more tags

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