[52d29f7] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[ff769b8c] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
---|
[52d29f7] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
[a2de57a7] | 7 | <!ENTITY imagemagick-patch-version "5">
|
---|
[67ab537] | 8 | <!ENTITY imagemagick-download-http "http://www.imagemagick.org/download/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.bz2">
|
---|
| 9 | <!ENTITY imagemagick-download-ftp "ftp://ftp.imagemagick.net/pub/ImageMagick/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.bz2">
|
---|
[6cc3f39] | 10 | <!ENTITY imagemagick-md5sum "1db7282df67272afb6b79dd87cd49bad">
|
---|
| 11 | <!ENTITY imagemagick-size "4.9 MB">
|
---|
| 12 | <!ENTITY imagemagick-buildsize "157 MB (additional 68 MB if you run the Image::Magick demo)">
|
---|
| 13 | <!ENTITY imagemagick-time "3.3 SBU (Additional 1.2 SBU to run the test suite)">
|
---|
[52d29f7] | 14 | ]>
|
---|
| 15 |
|
---|
[8d77de6] | 16 | <sect1 id="imagemagick"
|
---|
[93d2c72] | 17 | xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
|
---|
[db656dd] | 18 | <?dbhtml filename="imagemagick.html"?>
|
---|
[fc7afd0c] | 19 |
|
---|
[db656dd] | 20 | <sect1info>
|
---|
| 21 | <othername>$LastChangedBy$</othername>
|
---|
| 22 | <date>$Date$</date>
|
---|
| 23 | </sect1info>
|
---|
[fc7afd0c] | 24 |
|
---|
[db656dd] | 25 | <title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
|
---|
[fc7afd0c] | 26 |
|
---|
[db656dd] | 27 | <indexterm zone="imagemagick">
|
---|
| 28 | <primary sortas="a-ImageMagick">ImageMagick</primary>
|
---|
| 29 | </indexterm>
|
---|
| 30 |
|
---|
| 31 | <sect2 role="package">
|
---|
| 32 | <title>Introduction to ImageMagick</title>
|
---|
[fc7afd0c] | 33 |
|
---|
[8d77de6] | 34 | <para><application>ImageMagick</application> is a collection of tools and
|
---|
| 35 | libraries to read, write, and manipulate an image in various image formats.
|
---|
| 36 | Image processing operations are available from the command line. Bindings
|
---|
[db656dd] | 37 | to various programming languages are also available.</para>
|
---|
[fc7afd0c] | 38 |
|
---|
[db656dd] | 39 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 40 | <itemizedlist spacing="compact">
|
---|
| 41 | <listitem>
|
---|
| 42 | <para>Download (HTTP): <ulink url="&imagemagick-download-http;"/></para>
|
---|
| 43 | </listitem>
|
---|
| 44 | <listitem>
|
---|
| 45 | <para>Download (FTP): <ulink url="&imagemagick-download-ftp;"/></para>
|
---|
| 46 | </listitem>
|
---|
| 47 | <listitem>
|
---|
| 48 | <para>Download MD5 sum: &imagemagick-md5sum;</para>
|
---|
| 49 | </listitem>
|
---|
| 50 | <listitem>
|
---|
| 51 | <para>Download size: &imagemagick-size;</para>
|
---|
| 52 | </listitem>
|
---|
| 53 | <listitem>
|
---|
| 54 | <para>Estimated disk space required: &imagemagick-buildsize;</para>
|
---|
| 55 | </listitem>
|
---|
| 56 | <listitem>
|
---|
| 57 | <para>Estimated build time: &imagemagick-time;</para>
|
---|
| 58 | </listitem>
|
---|
| 59 | </itemizedlist>
|
---|
[fc7afd0c] | 60 |
|
---|
[db656dd] | 61 | <bridgehead renderas="sect3">ImageMagick Dependencies</bridgehead>
|
---|
[fc7afd0c] | 62 |
|
---|
[6cc3f39] | 63 | <bridgehead renderas="sect4">Recommended</bridgehead>
|
---|
[edc696c] | 64 | <para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
|
---|
[fc7afd0c] | 65 |
|
---|
[8d77de6] | 66 | <bridgehead renderas="sect4">Optional (Install Based on the Required
|
---|
[db656dd] | 67 | Format Support and Tools)</bridgehead>
|
---|
[8d77de6] | 68 | <para><xref linkend="lcms"/>,
|
---|
[edc696c] | 69 | <xref linkend="espgs"/> or <xref linkend="gs"/>,
|
---|
[8d77de6] | 70 | <xref linkend="libpng"/>,
|
---|
| 71 | <xref linkend="libjpeg"/>,
|
---|
| 72 | <xref linkend="freetype2"/>,
|
---|
| 73 | <xref linkend="libtiff"/>,
|
---|
| 74 | <xref linkend="libxml2"/>,
|
---|
| 75 | <xref linkend="tex"/>,
|
---|
| 76 | <xref linkend="gimp"/>,
|
---|
| 77 | <xref linkend="sane"/>,
|
---|
| 78 | <xref linkend="wget"/>,
|
---|
| 79 | <xref linkend="enscript"/>,
|
---|
[7567f93] | 80 | <xref linkend="libexif"/>,
|
---|
[8d77de6] | 81 | <ulink url="http://www.graphviz.org/">GraphViz</ulink>,
|
---|
| 82 | <ulink url="http://www.i3a.org/i_flashpix.html">FlashPIX</ulink> (or
|
---|
[db656dd] | 83 | <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/libfpx-1.2.0.9.tar.gz">
|
---|
[8d77de6] | 84 | FlashPIX library</ulink>),
|
---|
| 85 | <ulink url="http://www.ece.uvic.ca/~mdadams/jasper/">Jasper</ulink>,
|
---|
| 86 | <ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
|
---|
| 87 | <ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
|
---|
| 88 | <ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
|
---|
| 89 | <ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>,
|
---|
| 90 | <ulink url="http://www.cybercom.net/~dcoffin/dcraw/">DCRaw</ulink>,
|
---|
| 91 | <ulink url="http://www.xfig.org/">Transfig</ulink>,
|
---|
| 92 | <ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
|
---|
| 93 | <ulink url="http://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
|
---|
| 94 | <ulink url="http://user.it.uu.se/~jan/html2ps.html">html2ps</ulink>,
|
---|
| 95 | <ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>,
|
---|
| 96 | <ulink url="http://www.mpeg.org/MSSG/">MPEG-2 Video Codec</ulink>,
|
---|
| 97 | <ulink url="http://www.povray.org/">POV-Ray</ulink>,
|
---|
[fc7afd0c] | 98 | <ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
|
---|
[8d77de6] | 99 | (or <ulink
|
---|
[db656dd] | 100 | url="http://www.funet.fi/pub/graphics/packages/Utah-Raster-Toolkit/rel3/urt-3.1b.mlg.tar.gz">
|
---|
[8d77de6] | 101 | source</ulink>),
|
---|
| 102 | <ulink url="http://txt2html.sourceforge.net/">txt2html</ulink>,
|
---|
| 103 | <ulink url="http://radsite.lbl.gov/radiance/HOME.html">Radiance</ulink>,
|
---|
| 104 | <ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
|
---|
[6cc3f39] | 105 | <ulink url="http://www.artifex.com/downloads/">GhostPCL</ulink>,
|
---|
[8d77de6] | 106 | <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink> and
|
---|
[db656dd] | 107 | <ulink url="http://dmalloc.com/">Dmalloc</ulink></para>
|
---|
[fc7afd0c] | 108 |
|
---|
[db656dd] | 109 | </sect2>
|
---|
[fc7afd0c] | 110 |
|
---|
[db656dd] | 111 | <sect2 role="installation">
|
---|
| 112 | <title>Installation of ImageMagick</title>
|
---|
| 113 |
|
---|
| 114 | <para>Install <application>Imagemagick</application> by running the following
|
---|
| 115 | commands:</para>
|
---|
| 116 |
|
---|
[6cc3f39] | 117 | <screen><userinput>./configure --prefix=/usr --with-modules &&
|
---|
[db656dd] | 118 | make</userinput></screen>
|
---|
[fc7afd0c] | 119 |
|
---|
[6cc3f39] | 120 | <para>To test the results, issue: <command>make check</command>.</para>
|
---|
| 121 |
|
---|
[f503cd16] | 122 | <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
|
---|
[fc7afd0c] | 123 |
|
---|
[db656dd] | 124 | <screen role="root"><userinput>make install</userinput></screen>
|
---|
| 125 |
|
---|
| 126 | <sect3>
|
---|
| 127 | <title>Additional Configure Options</title>
|
---|
[fc7afd0c] | 128 |
|
---|
[8d77de6] | 129 | <para>There are additional switches that can be passed to
|
---|
[aa07b6c] | 130 | <application>ImageMagick</application> to customize the installation to
|
---|
[a2de57a7] | 131 | your needs. See <filename>advanced-unix-installation.html</filename> in
|
---|
| 132 | the <filename class='directory'>www</filename> directory.</para>
|
---|
[fc7afd0c] | 133 |
|
---|
[db656dd] | 134 | </sect3>
|
---|
[fc7afd0c] | 135 |
|
---|
[db656dd] | 136 | </sect2>
|
---|
[fc7afd0c] | 137 |
|
---|
[db656dd] | 138 | <sect2 role="commands">
|
---|
| 139 | <title>Command Explanations</title>
|
---|
| 140 |
|
---|
[6cc3f39] | 141 | <!--
|
---|
[8d77de6] | 142 | <para><command>sed -i -e 's/\$(LIBLTDL) \$/\$/' Makefile.in</command>: The
|
---|
| 143 | package will build and install a different version of the
|
---|
| 144 | <application>Libtool</application> library in
|
---|
| 145 | <filename class='directory'>/usr/lib</filename>. This command forces the
|
---|
[bbdb0ff4] | 146 | package to link to the installed version of
|
---|
[db656dd] | 147 | <filename class='libraryfile'>libltdl</filename>, and not replace it.</para>
|
---|
[6cc3f39] | 148 | -->
|
---|
[fc7afd0c] | 149 |
|
---|
[8d77de6] | 150 | <para><parameter>--with-modules</parameter>: Enables support for dynamically
|
---|
[db656dd] | 151 | loadable modules.</para>
|
---|
[fc7afd0c] | 152 |
|
---|
[db656dd] | 153 | </sect2>
|
---|
[fc7afd0c] | 154 |
|
---|
[db656dd] | 155 | <sect2 role="content">
|
---|
| 156 | <title>Contents</title>
|
---|
| 157 |
|
---|
| 158 | <segmentedlist>
|
---|
| 159 | <segtitle>Installed Programs</segtitle>
|
---|
| 160 | <segtitle>Installed Libraries</segtitle>
|
---|
| 161 | <segtitle>Installed Directories</segtitle>
|
---|
[fc7afd0c] | 162 |
|
---|
[db656dd] | 163 | <seglistitem>
|
---|
| 164 | <seg>animate, compare, composite, conjure, convert, display,
|
---|
| 165 | identify, import, Magick-config, Magick++-config, mogrify,
|
---|
| 166 | montage, and Wand-config</seg>
|
---|
[8d77de6] | 167 | <seg>libMagick.[so,a], libMagick++.[so,a], libWand.[so,a],
|
---|
[a2de57a7] | 168 | the Magick.so Perl module, and numerous plugin modules</seg>
|
---|
[6cc3f39] | 169 | <seg>/usr/include/Magick++, /usr/include/magick, /usr/include/wand,
|
---|
[8d77de6] | 170 | /usr/lib/ImageMagick-&imagemagick-version;,
|
---|
[6cc3f39] | 171 | /usr/lib/perl5/site_perl/&LFS-Perl-version;/i686-linux/auto/Image/Magick,
|
---|
| 172 | /usr/share/ImageMagick-&imagemagick-version; and
|
---|
| 173 | /usr/share/doc/ImageMagick-&imagemagick-version;</seg>
|
---|
[db656dd] | 174 | </seglistitem>
|
---|
| 175 | </segmentedlist>
|
---|
[fc7afd0c] | 176 |
|
---|
[db656dd] | 177 | <variablelist>
|
---|
| 178 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
[fc7afd0c] | 179 | <?dbfo list-presentation="list"?>
|
---|
[db656dd] | 180 | <?dbhtml list-presentation="table"?>
|
---|
[fc7afd0c] | 181 |
|
---|
[db656dd] | 182 | <varlistentry id="animate">
|
---|
| 183 | <term><command>animate</command></term>
|
---|
| 184 | <listitem>
|
---|
| 185 | <para>animates a sequence of images.</para>
|
---|
| 186 | <indexterm zone="imagemagick animate">
|
---|
| 187 | <primary sortas="b-animate">animate</primary>
|
---|
| 188 | </indexterm>
|
---|
| 189 | </listitem>
|
---|
| 190 | </varlistentry>
|
---|
[fc7afd0c] | 191 |
|
---|
[db656dd] | 192 | <varlistentry id="compare">
|
---|
| 193 | <term><command>compare</command></term>
|
---|
| 194 | <listitem>
|
---|
| 195 | <para>compares an image to a reconstructed image.</para>
|
---|
| 196 | <indexterm zone="imagemagick compare">
|
---|
| 197 | <primary sortas="b-compare">compare</primary>
|
---|
| 198 | </indexterm>
|
---|
| 199 | </listitem>
|
---|
| 200 | </varlistentry>
|
---|
[fc7afd0c] | 201 |
|
---|
[db656dd] | 202 | <varlistentry id="composite">
|
---|
| 203 | <term><command>composite</command></term>
|
---|
| 204 | <listitem>
|
---|
| 205 | <para>composites various images into the given base image.</para>
|
---|
| 206 | <indexterm zone="imagemagick composite">
|
---|
| 207 | <primary sortas="b-composite">composite</primary>
|
---|
| 208 | </indexterm>
|
---|
| 209 | </listitem>
|
---|
| 210 | </varlistentry>
|
---|
[fc7afd0c] | 211 |
|
---|
[db656dd] | 212 | <varlistentry id="conjure">
|
---|
| 213 | <term><command>conjure</command></term>
|
---|
| 214 | <listitem>
|
---|
| 215 | <para>processes a MSL script to create an image.</para>
|
---|
| 216 | <indexterm zone="imagemagick conjure">
|
---|
| 217 | <primary sortas="b-conjure">conjure</primary>
|
---|
| 218 | </indexterm>
|
---|
| 219 | </listitem>
|
---|
| 220 | </varlistentry>
|
---|
[fc7afd0c] | 221 |
|
---|
[db656dd] | 222 | <varlistentry id="convert">
|
---|
| 223 | <term><command>convert</command></term>
|
---|
| 224 | <listitem>
|
---|
| 225 | <para>converts image(s) from one format to another.</para>
|
---|
| 226 | <indexterm zone="imagemagick convert">
|
---|
| 227 | <primary sortas="b-convert">convert</primary>
|
---|
| 228 | </indexterm>
|
---|
| 229 | </listitem>
|
---|
| 230 | </varlistentry>
|
---|
[fc7afd0c] | 231 |
|
---|
[db656dd] | 232 | <varlistentry id="display">
|
---|
| 233 | <term><command>display</command></term>
|
---|
| 234 | <listitem>
|
---|
| 235 | <para>displays an image.</para>
|
---|
| 236 | <indexterm zone="imagemagick display">
|
---|
| 237 | <primary sortas="b-display">display</primary>
|
---|
| 238 | </indexterm>
|
---|
| 239 | </listitem>
|
---|
| 240 | </varlistentry>
|
---|
[fc7afd0c] | 241 |
|
---|
[db656dd] | 242 | <varlistentry id="identify">
|
---|
| 243 | <term><command>identify</command></term>
|
---|
| 244 | <listitem>
|
---|
| 245 | <para>describes the format and characteristics of an image file.</para>
|
---|
| 246 | <indexterm zone="imagemagick identify">
|
---|
| 247 | <primary sortas="b-identify">identify</primary>
|
---|
| 248 | </indexterm>
|
---|
| 249 | </listitem>
|
---|
| 250 | </varlistentry>
|
---|
[fc7afd0c] | 251 |
|
---|
[db656dd] | 252 | <varlistentry id="import">
|
---|
| 253 | <term><command>import</command></term>
|
---|
| 254 | <listitem>
|
---|
| 255 | <para>captures an X window.</para>
|
---|
| 256 | <indexterm zone="imagemagick import">
|
---|
| 257 | <primary sortas="b-import">import</primary>
|
---|
| 258 | </indexterm>
|
---|
| 259 | </listitem>
|
---|
| 260 | </varlistentry>
|
---|
[fc7afd0c] | 261 |
|
---|
[db656dd] | 262 | <varlistentry id="magick-config">
|
---|
[8d77de6] | 263 | <term><command>Magick-config</command> and
|
---|
[db656dd] | 264 | <command>Magick++-config</command></term>
|
---|
| 265 | <listitem>
|
---|
| 266 | <para>show information about the installed versions of
|
---|
| 267 | <application>ImageMagick</application> and Magick++.</para>
|
---|
| 268 | <indexterm zone="imagemagick magick-config">
|
---|
| 269 | <primary sortas="b-Magick-config">Magick-config</primary>
|
---|
| 270 | </indexterm>
|
---|
| 271 | </listitem>
|
---|
| 272 | </varlistentry>
|
---|
[fc7afd0c] | 273 |
|
---|
[db656dd] | 274 | <varlistentry id="mogrify">
|
---|
| 275 | <term><command>mogrify</command></term>
|
---|
| 276 | <listitem>
|
---|
| 277 | <para>transforms an image.</para>
|
---|
| 278 | <indexterm zone="imagemagick mogrify">
|
---|
| 279 | <primary sortas="b-mogrify">mogrify</primary>
|
---|
| 280 | </indexterm>
|
---|
| 281 | </listitem>
|
---|
| 282 | </varlistentry>
|
---|
[fc7afd0c] | 283 |
|
---|
[db656dd] | 284 | <varlistentry id="montage">
|
---|
| 285 | <term><command>montage</command></term>
|
---|
| 286 | <listitem>
|
---|
| 287 | <para>composites various images into a new image.</para>
|
---|
| 288 | <indexterm zone="imagemagick montage">
|
---|
| 289 | <primary sortas="b-montage">montage</primary>
|
---|
| 290 | </indexterm>
|
---|
| 291 | </listitem>
|
---|
| 292 | </varlistentry>
|
---|
[fc7afd0c] | 293 |
|
---|
[db656dd] | 294 | <varlistentry id="wand-config">
|
---|
| 295 | <term><command>Wand-config</command></term>
|
---|
| 296 | <listitem>
|
---|
| 297 | <para>shows the options required to use the Wand library.</para>
|
---|
| 298 | <indexterm zone="imagemagick wand-config">
|
---|
| 299 | <primary sortas="b-Wand-config">Wand-config</primary>
|
---|
| 300 | </indexterm>
|
---|
| 301 | </listitem>
|
---|
| 302 | </varlistentry>
|
---|
[fc7afd0c] | 303 |
|
---|
[db656dd] | 304 | <varlistentry id="perlmagick">
|
---|
| 305 | <term><filename class='libraryfile'>Image::Magick</filename></term>
|
---|
| 306 | <listitem>
|
---|
[8d77de6] | 307 | <para>allows the reading, manipulation and writing of a large number of
|
---|
[fc7afd0c] | 308 | image file formats using the <application>ImageMagick</application>
|
---|
[8d77de6] | 309 | library. Run <command>make</command> in the
|
---|
| 310 | <filename class='directory'>PerlMagick/demo</filename> directory of
|
---|
[6cc3f39] | 311 | the package source tree after the package is installed to see a nice
|
---|
| 312 | demo of the module's capabilities.</para>
|
---|
[db656dd] | 313 | <indexterm zone="imagemagick perlmagick">
|
---|
| 314 | <primary sortas="g-Image-Magick">Image::Magick</primary>
|
---|
| 315 | </indexterm>
|
---|
| 316 | </listitem>
|
---|
| 317 | </varlistentry>
|
---|
[fc7afd0c] | 318 |
|
---|
[db656dd] | 319 | </variablelist>
|
---|
| 320 |
|
---|
| 321 | </sect2>
|
---|
[f828f6a] | 322 |
|
---|
| 323 | </sect1>
|
---|