glfs/general/genutils/imagemagick.xml
Fernando de Oliveira ab479cdafc libtasn1-3.6, ImageMagick-6.8.9-1 and webkitgtk-2.4.3. Fix to Doxygen-1.8.7.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@13177 af4574ff-66df-0310-9fd7-8a98e5e911e0
2014-05-26 21:26:48 +00:00

542 lines
21 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY imagemagick-patch-version "1">
<!-- Not sure what to do here as ImageMagick is one of the fastest-moving
targets in all of open-source. One solution is to always use the last
version of a specific major-minor from the 'legacy' subdirectory of
the path in these URL's. Otherwise these links are broken within days
after updates :-( Unfortunately, versions always roll on after patch
version 10, whether or not significant changes occur, and it takes
time before versions migrate to legacy/ -->
<!ENTITY imagemagick-download-http " ">
<!ENTITY imagemagick-download-ftp "ftp://ftp.imagemagick.org/pub/ImageMagick/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz">
<!ENTITY imagemagick-md5sum "bde038ae05fb20d29cebf88ab9cbdce5">
<!ENTITY imagemagick-size "7.2 MB">
<!ENTITY imagemagick-buildsize "147 MB (with typical dependencies, additional 25 MB to run the test suite, reputedly 450 MB with all dependencies)">
<!ENTITY imagemagick-time "2.5 SBU (typical build - additional 8.1 SBU to run the test suite and 15 SBU to run the validation suite)">
]>
<!-- Editors: It is highly unlikely that the buildsize (disk space used) will
be less than the figure shown above. Unless you have installed *all* the
delegate dependencies, you will see a smaller buildsize, but what is
currently listed above is the space one would require if all the
dependencies are installed, which is what we want.
Marked as 'typical' because nobody builds ALL the optional extras [ken]
Saved the "full" 450MB as a comment - feel free to update this iff you
do build all dependencies, it's probably a lot bigger now.
Also, please look over the output from the configure command for any
additional dependencies that need to be listed, as ImageMagick is
constantly adding additional features and dependencies. -->
<sect1 id="imagemagick"
xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
<?dbhtml filename="imagemagick.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
<indexterm zone="imagemagick">
<primary sortas="a-ImageMagick">ImageMagick</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to ImageMagick</title>
<para>
<application>ImageMagick</application> is a collection of tools and
libraries to read, write, and manipulate an image in various image formats.
Image processing operations are available from the command line. Bindings
for Perl and C++ are also available.
</para>
&lfs75_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&imagemagick-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&imagemagick-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &imagemagick-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &imagemagick-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &imagemagick-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &imagemagick-time;</para>
</listitem>
</itemizedlist>
<note>
<para>
The <application>ImageMagick</application> source releases are
updated frequently and the version shown above may no longer be available
from the download locations. You can download a more recent version and use
the existing BLFS instructions to install it. Chances are that it will
work just fine, but this has not been tested by the BLFS team. If the
package version shown above is not available from the locations shown
above, or from the <filename class='directory'>legacy/</filename> directory
at <literal>ftp.ImageMagick.org/pub/ImageMagick</literal> you can download it
from the BLFS package server at <ulink
url="&sources-anduin-http;/i/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.xz"/>.
</para>
</note>
<bridgehead renderas="sect3">ImageMagick Dependencies</bridgehead>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="x-window-system"/>
</para>
<para>
The optional dependencies listed below should be installed if you
need support for the specific format or the conversion tool the dependency
provides. Many of the dependencies' capabilities and uses are described in
the <quote>MAGICK DELEGATES</quote> section of the
<filename>README.txt</filename> file located in the source tree. Additional
information about the dependencies can be found in the
<filename>Install-unix.txt</filename> file located in the source tree as
well as issuing the <command>./configure --help</command> command. A
summary of this information, as well as some additional notes can be viewed
on-line at <ulink
url="http://www.imagemagick.org/script/advanced-unix-installation.php"/>.
</para>
<bridgehead renderas="sect4">Optional System Utilities</bridgehead>
<para role="optional">
<xref linkend="cups"/>,
<xref linkend="curl"/>,
<ulink url="http://dmalloc.com/">Dmalloc</ulink>,
<ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>,
<xref linkend="ffmpeg"/>,
<ulink url="http://www.fftw.org/">FFTW</ulink>,
<ulink url="http://www.mupdf.com/">MuPDF</ulink>,
<!-- <ulink url="http://www.gsp.com/support/virtual/email/pgp/">PGP</ulink> or -->
<ulink url="http://www.openpgp.org/resources/downloads">PGP</ulink> or
<xref linkend="gnupg2"/>
(you'll have to do some hacking to use <application>GnuPG</application>),
<xref linkend="p7zip"/> (LZMA),
<ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/profiles.zip">Profiles</ulink>,
<xref linkend="sane"/>,
<ulink url="http://ufraw.sourceforge.net/">ufraw</ulink> (for raw formats listed in
<filename>www/formats.html</filename>),
<xref linkend="wget"/>, and
<xref linkend="xdg-utils"/>
</para>
<bridgehead renderas="sect4">Optional Graphics Libraries</bridgehead>
<para role="optional">
<ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
<ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
<!-- <ulink url="http://www.i3a.org/i_flashpix.html">FlashPIX</ulink> (or -->
<ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/">
FlashPIX (libfpx)</ulink>,
<!-- Added already from the Xorg recommended dependency <xref linkend="freetype2"/>, -->
<xref linkend="jasper"/>,
<ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
<xref linkend="lcms"/> or
<xref linkend="lcms2"/>,
<xref linkend="libexif"/>,
<xref linkend="libjpeg"/>,
<xref linkend="libpng"/>,
<xref linkend="librsvg"/>,
<xref linkend="libtiff"/>,
<xref linkend="libwebp"/>,
<ulink url="http://liblqr.wikidot.com/en:download-page">Liquid Rescale</ulink>,
<ulink url="http://www.openexr.com/">OpenEXR</ulink>,
<xref linkend="openjpeg"/>,
<xref linkend="pango"/>, and
<ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>
(or <ulink url="http://www.mcmurchy.com/ralcgm/ralcgm-3.51.tar.gz">ralcgm</ulink>)
</para>
<bridgehead renderas="sect4">Optional Graphics Utilities</bridgehead>
<para role="optional">
<ulink url="http://www.blender.org/">Blender</ulink>,
<ulink url="http://dejavu.sourceforge.net/">DejaVu fonts</ulink>,
<ulink url="http://www.ghostscript.com/download/gpcldnld.html">GhostPCL</ulink> or
<ulink url="http://www.ghostscript.com/download/gpdldnld.html">GhostPDL</ulink>,
<xref linkend="gs"/>,
<xref linkend="gimp"/>,
<ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
<xref linkend="graphviz"/>,
<xref linkend="inkscape"/>,
<ulink url="http://www.povray.org/">POV-Ray</ulink>, and
<ulink url="http://radsite.lbl.gov/radiance/HOME.html">Radiance</ulink>
</para>
<bridgehead renderas="sect4">Optional Conversion Tools</bridgehead>
<para role="optional">
<ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
<xref linkend="enscript"/>,
<ulink url="http://www.lizardtech.com/downloads/category/">
GeoExpress Command Line Utilities, AKA MrSID Utilities (binary package)</ulink>,
<ulink url="http://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
<ulink url="http://user.it.uu.se/~jan/html2ps.html">html2ps</ulink>,
<ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
<ulink url="http://www.mpeg.org/MSSG/">MPEG-2 Video Codec</ulink>,
<ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>,
<xref linkend="texlive"/>,
<ulink url="http://www.xfig.org/">Transfig</ulink>,
<!-- <ulink url="http://txt2html.sourceforge.net/">txt2html</ulink>
(requires Perl Module
<ulink url="http://cpan.org/authors/id/J/JS/JSTENZEL/Getopt-ArgvFile-1.11.tar.gz">
Getopt::ArgvFile</ulink>), and -->
<ulink url="http://sk1project.org/modules.php?name=products&amp;product=uniconvertor">
UniConvertor</ulink>, and
<ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
(or <ulink url="http://www.mcmurchy.com/urt/urt-3.1b.tar.gz">URT-3.1b</ulink>)
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/imagemagick"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of ImageMagick</title>
<para>
Install <application>Imagemagick</application> by running the following commands:
</para>
<!-- <note><para>
If Xorg is not installed in user, add the entry LDFLAGS=-L$XORG_PREFIX/lib
to the configure line.
</para></note>
-->
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc \
--with-modules \
--with-perl \
--disable-static &amp;&amp;
make</userinput></screen>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
<para>
To test the installation, issue: <command>make check</command>. For a more
comprehensive test, run the <application>ImageMagick</application>
validation suite, also after the package is installed. Note that the EPS,
PS, and PDF tests require a working
<application>Ghostscript</application>. One test needs "Helvetica" from
"Standard Fonts" which are optionally installed in <xref linkend="gs"/>.
</para>
<!-- This is not necessary as the 'make install' process installs PerlMagick
<para>
And, if you built PerlMagick, still as the
<systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make -C PerlMagick install</userinput></screen>
-->
<!-- Commenting this out for now as it is redundant to information
that has already been presented, or is in the 'command explanations'
section below.
<sect3>
<title>Additional Configure Options</title>
<para>There are additional switches that can be passed to
<application>ImageMagick</application> to customize the installation to
your needs. See <filename>advanced-unix-installation.html</filename> in
the <filename class='directory'>www</filename> directory.</para>
</sect3>
-->
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<parameter>--sysconfdir=/etc</parameter>: Install the
<filename class="extension">.xml</filename> configuration files into
<filename class='directory'>/etc/ImageMagick</filename> instead of the
default <filename class='directory'>/usr/etc/ImageMagick</filename>.
</para>
<para>
<parameter>--with-modules</parameter>: Enables support for dynamically
loadable modules.
</para>
<para>
<parameter>--with-perl</parameter>: Enables building and installing
PerlMagick.
</para>
<para>
<parameter>--disable-static</parameter>: Prevents the static
libraries being built and installed.
</para>
<!-- The tests run fine if you run the validation suite after the package
is installed
<para>
<parameter>-without-magick-plus-plus</parameter>: Disables building
and installing Magick++. All the test modules and demos for Magick++
currently fail.
</para>
-->
<para>
<option>--with-gslib=/usr/lib</option>: Enables support to use the
<application>Ghostscript</application> shared library.
</para>
<para>
<option>--with-rsvg</option>: Enables support to use the
<application>librsvg</application> library.
</para>
<para>
<option>--with-autotrace</option>: Enables support to use the
<application>Autotrace</application> library.
</para>
<para>
<option>--with-wmf</option>: Enables support to use the
<application>libwmf</application> library.
</para>
<para>
<option>--with-gvc</option>: Enables support to use
<application>GraphViz</application>.
</para>
<para>
<option>--with-windows-font-dir=
<replaceable>&lt;Some/Directory&gt;</replaceable></option>:
This option specifies the directory where the Windows CoreFonts are
installed.
</para>
<para>
<option>--with-dejavu-font-dir=
<replaceable>&lt;Some/Directory&gt;</replaceable></option>:
This option specifies the directory where the DejaVu fonts are
installed.
</para>
<para>
The options and parameters listed above are the only ones you should
have to pass to the <command>configure</command> script to activate all
the delegate dependencies. All other dependencies will be automatically
detected and utilized in the build if they are installed.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>animate, compare, composite, conjure, convert, display,
identify, import, Magick-config, Magick++-config, MagickCore-config,
MagickWand-config, mogrify, montage, stream, and Wand-config</seg>
<seg>libMagickCore-6.Q16.so, libMagickWand-6.Q16.so,
libMagick++-6.Q16.so,
numerous modules under
/usr/lib/ImageMagick-&imagemagick-version;/modules-Q16/{coders,filters}/,
/usr/lib/perl5/site_perl/&lfs-perl-version;/auto/Image/Magick/Magick.so, and
/usr/lib/perl5/site_perl/&lfs-perl-version;/auto/Image/Magick/Q16/Q16.so</seg>
<seg>/etc/ImageMagick-6,
/usr/include/ImageMagick-6,
/usr/lib/ImageMagick-&imagemagick-version;,
/usr/lib/perl5/site_perl/&lfs-perl-version;/auto/Image,
/usr/lib/perl5/site_perl/&lfs-perl-version;/Image,
/usr/share/ImageMagick-6 and
/usr/share/doc/ImageMagick-6</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="animate">
<term><command>animate</command></term>
<listitem>
<para>animates a sequence of images.</para>
<indexterm zone="imagemagick animate">
<primary sortas="b-animate">animate</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="compare">
<term><command>compare</command></term>
<listitem>
<para>compares an image to a reconstructed image.</para>
<indexterm zone="imagemagick compare">
<primary sortas="b-compare">compare</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="composite">
<term><command>composite</command></term>
<listitem>
<para>composites various images into the given base image.</para>
<indexterm zone="imagemagick composite">
<primary sortas="b-composite">composite</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="conjure">
<term><command>conjure</command></term>
<listitem>
<para>processes a MSL script to create an image.</para>
<indexterm zone="imagemagick conjure">
<primary sortas="b-conjure">conjure</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="convert">
<term><command>convert</command></term>
<listitem>
<para>converts image(s) from one format to another.</para>
<indexterm zone="imagemagick convert">
<primary sortas="b-convert">convert</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="display">
<term><command>display</command></term>
<listitem>
<para>displays an image.</para>
<indexterm zone="imagemagick display">
<primary sortas="b-display">display</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="identify">
<term><command>identify</command></term>
<listitem>
<para>describes the format and characteristics of an image file.</para>
<indexterm zone="imagemagick identify">
<primary sortas="b-identify">identify</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="import">
<term><command>import</command></term>
<listitem>
<para>captures an X window.</para>
<indexterm zone="imagemagick import">
<primary sortas="b-import">import</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="magick-config">
<term><command>Magick{,++,Core,Wand}-config</command></term>
<listitem>
<para>show information about the installed versions of the
<application>ImageMagick</application> libraries.</para>
<indexterm zone="imagemagick magick-config">
<primary sortas="b-Magick-config">Magick-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mogrify">
<term><command>mogrify</command></term>
<listitem>
<para>transforms an image.</para>
<indexterm zone="imagemagick mogrify">
<primary sortas="b-mogrify">mogrify</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="montage">
<term><command>montage</command></term>
<listitem>
<para>composites various images into a new image.</para>
<indexterm zone="imagemagick montage">
<primary sortas="b-montage">montage</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="stream">
<term><command>stream</command></term>
<listitem>
<para>streams one or more pixel components of an image or
portion of the image to your choice of storage formats.</para>
<indexterm zone="imagemagick stream">
<primary sortas="b-stream">stream</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wand-config">
<term><command>Wand-config</command></term>
<listitem>
<para>shows the options required to use the Wand library.</para>
<indexterm zone="imagemagick wand-config">
<primary sortas="b-Wand-config">Wand-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="perlmagick">
<term><filename class='libraryfile'>Image::Magick</filename></term>
<listitem>
<para>allows the reading, manipulation and writing of a large number of
image file formats using the <application>ImageMagick</application>
library. Run <command>make</command> in the
<filename class='directory'>PerlMagick/demo</filename> directory of
the package source tree after the package is installed to see a nice
demo of the module's capabilities.</para>
<indexterm zone="imagemagick perlmagick">
<primary sortas="g-Image-Magick">Image::Magick</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>