source: general/genutils/imagemagick.xml@ 20cdff5

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY imagemagick-patch-version "7">
  <!ENTITY imagemagick-download-http "http://www.imagemagick.org/download/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.gz">
  <!ENTITY imagemagick-download-ftp  "ftp://ftp.imagemagick.net/pub/ImageMagick/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.gz">
  <!ENTITY imagemagick-size          "5.5 MB">
  <!ENTITY imagemagick-buildsize     "146 MB">
  <!ENTITY imagemagick-time          "2.99 SBU">
]>

<sect1 id="imagemagick" xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="imagemagick.html"?>
<title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>

<sect2>
<title>Introduction to <application>ImageMagick</application></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 
to various programming languages are also available.</para>

<sect3><title>Package information</title>
<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 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>
</sect3>

<sect3><title><application>ImageMagick</application> dependencies</title>

<sect4><title>Recommended</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), and
<xref linkend="espgs"/> or <xref linkend="gs"/></para>
</sect4>

<sect4><title>Optional (install based on the required format support and 
tools)</title>
<para><xref linkend="lcms"/>, 
<xref linkend="libpng"/>, 
<xref linkend="libjpeg"/>, 
<xref linkend="freetype2"/>, 
<xref linkend="libtiff"/>, 
<xref linkend="libxml2"/>, 
<xref linkend="mozilla"/>, 
<xref linkend="tex"/>, 
<xref linkend="gimp"/>, 
<xref linkend="sane"/>, 
<xref linkend="wget"/>, 
<xref linkend="enscript"/>, 
<ulink url="http://www.graphviz.org/">GraphViz</ulink>, 
<ulink url="http://www.i3a.org/i_flashpix.html">FlashPIX</ulink> (or 
<ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/libfpx-1.2.0.9.tar.gz">FlashPIX 
library</ulink>), 
<ulink url="http://www.ece.uvic.ca/~mdadams/jasper/">Jasper</ulink>, 
<ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>, 
<ulink url="http://wvware.sourceforge.net/">libwmf</ulink>, 
<ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>, 
<ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>, 
<ulink url="http://www.cybercom.net/~dcoffin/dcraw/">DCRaw</ulink>, 
<ulink url="http://www.xfig.org/">Transfig</ulink>, 
<ulink url="http://www.gnuplot.info/">Gnuplot</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://netpbm.sourceforge.net/">Netpbm</ulink>, 
<ulink url="http://www.mpeg.org/MSSG/">MPEG-2 Video Codec</ulink>, 
<ulink url="http://www.povray.org/">POV-Ray</ulink>, 
<ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink> 
(or <ulink url="http://www.funet.fi/pub/graphics/packages/Utah-Raster-Toolkit/rel3/urt-3.1b.mlg.tar.gz">source</ulink>), 
<ulink url="http://txt2html.sourceforge.net/">txt2html</ulink>, 
<ulink url="http://sourceforge.net/projects/libexif/">libexif</ulink>, 
<ulink url="http://radsite.lbl.gov/radiance/HOME.html">Radiance</ulink>, 
<ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>, 
<ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink> and 
<ulink url="http://dmalloc.com/">Dmalloc</ulink></para>
</sect4>

</sect3>

</sect2>

<sect2>
<title>Installation of <application>ImageMagick</application></title>

<para>Install <application>Imagemagick</application> by running the following
commands:</para>

<screen><userinput><command>sed -i -e 's/\$(LIBLTDL) \$/\$/' Makefile.in &amp;&amp;
./configure --prefix=/usr --with-modules &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

<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. Check out the <application>ImageMagick</application> installation 
instructions at <ulink url="http://www.imagemagick.org/www/Install-unix.html"/>.
</para>
</sect3>

</sect2>

<sect2>
<title>Command Explanations</title>

<para><command>sed -i -e 's/\$(LIBLTDL) \$/\$/' Makefile.in</command>: The 
package will build and install a different version of the 
<application>Libtool</application> library in 
<filename class='directory'>/usr/lib</filename>. This command forces the 
package to link to the installed version of  
<filename class='libraryfile'>libltdl</filename>, and not replace it.</para>

<para><parameter>--with-modules</parameter>: Enables support for dynamically 
loadable modules.</para>

</sect2>

<sect2>
<title>Contents</title>

<para><application>ImageMagick</application> contains 
<command>animate</command>,
<command>compare</command>,
<command>composite</command>,
<command>conjure</command>,
<command>convert</command>,
<command>display</command>,
<command>identify</command>,
<command>import</command>,
<command>Magick-config</command>,
<command>Magick++-config</command>,
<command>mogrify</command>,
<command>montage</command>, 
<command>Wand-config</command>, 
<filename class="libraryfile">libMagick</filename>, 
<filename class="libraryfile">libMagick++</filename> and 
<filename class="libraryfile">libWand</filename> libraries, 
numerous delegate modules and the 
Image::Magick <application>Perl</application> module.</para>
 
</sect2>

<sect2><title>Description</title>
 
<sect3><title>animate</title>
<para>Animates a sequence of images.</para></sect3>
 
<sect3><title>compare</title>
<para>Compares an image to a reconstructed image.</para></sect3>
 
<sect3><title>composite</title>
<para>Composites various images into the given base image.</para></sect3>
 
<sect3><title>conjure</title>
<para>Processes a Magick Scripting Language (MSL) script to create
an image.</para></sect3>
 
<sect3><title>convert</title>
<para>Convert image(s) from one format to another.</para></sect3>
 
<sect3><title>display</title>
<para>Display an image.</para></sect3>
 
<sect3><title>identify</title>
<para>Describes the format and characteristics of an image file.</para></sect3>

<sect3><title>import</title>
<para>Captures an X window.</para></sect3>
 
<sect3><title>Magick-config and Magick++-config</title>
<para>Get information about the installed versions of 
<application>ImageMagick</application> and Magick++.</para></sect3>
 
<sect3><title>mogrify</title>
<para>Transforms an image.</para></sect3>
 
<sect3><title>montage</title>
<para>Composites various images into a new image.</para></sect3>
 
<sect3><title>Wand-config</title>
<para>Get the options required to use the Wand library.</para></sect3>

<sect3><title>Image::Magick <application>Perl</application> module</title>
<para>The Image::Magic module 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 to see a nice demo of the module's capabilities.</para>
</sect3>

</sect2>

</sect1>