source: archive/imagemagick6.xml

trunk
Last change on this file was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.
  • Property mode set to 100644
File size: 17.0 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 imagemagick6-patch-version "93">
8
9 <!ENTITY imagemagick6-download-http "https://www.imagemagick.org/download/releases/ImageMagick-&imagemagick6-version;-&imagemagick6-patch-version;.tar.xz">
10 <!ENTITY imagemagick6-download-ftp "ftp://ftp.imagemagick.org/pub/ImageMagick/releases/ImageMagick-&imagemagick6-version;-&imagemagick6-patch-version;.tar.xz">
11 <!ENTITY imagemagick6-md5sum "ddbb2bed4145e3f7b0ff6c105ddbf612">
12 <!ENTITY imagemagick6-size "8.7 MB">
13 <!ENTITY imagemagick6-buildsize "158 MB, with typical dependencies (add 40 MB for tests)">
14 <!ENTITY imagemagick6-time "0.9 SBU (Using parallelism=4; add 1.9 SBU for tests)">
15]>
16
17<!-- Editors: It is highly unlikely that the buildsize (disk space used) will
18 be less than the figure shown above. Unless you have installed *all* the
19 delegate dependencies, you will see a smaller buildsize, but what is
20 currently listed above is the space one would require if all the
21 dependencies available in the book are installed.
22
23 [bdubbs 2019-92-09] Reduced SBU and disk space for libraries only.
24
25 [bdubbs 2018-08-26] I upddated the above stats slightly for 8.3. All BLFS
26 dependencies were installed except gimp and texlive. Note that at this
27 writing the only packages in the book that use this are gimp and
28 inkscape.
29
30 [pierre 2017-02-14] For a build of 6.9.7-8 with dependencies available in
31 the book, but with the configure command as below, I got 179 MB (2.3 SBU)
32 (and 472 KB (0.8 SBU) for the validation suite).
33
34 For a non-full build of 6.9.3-8 I got an actual space of 173 MB and running
35 the validation suite does not increase the net space. I recommend running
36 that instead of check (after the install)!
37
38 Following comments preserved from when we did a full install of -6.
39
40 Marked as 'typical' because nobody builds ALL the optional extras [ken]
41
42 [bdubbs] I do; at least the internal ones. I still got only 200 MB.
43
44 Saved the "full" 450MB as a comment - feel free to update this iff you
45 do build all dependencies, it's probably a lot bigger now.
46
47 [bdubbs] Just removed it. I don't think it adds anything.
48
49 Also, please look over the output from the configure command for any
50 additional dependencies that need to be listed, as ImageMagick is
51 constantly adding additional features and dependencies.
52
53 For those of us who touch this infrequently:
54 DPS/dpsXclient is from apple so not relevant to linux builds
55 GVC is part of Graphviz and documented in the explanations
56 LQR is Liquid Rescale
57
58 -->
59
60<sect1 id="imagemagick6" xreflabel="ImageMagick-&imagemagick6-version;-&imagemagick6-patch-version; libraries">
61 <?dbhtml filename="imagemagick6.html"?>
62
63
64 <title>ImageMagick-&imagemagick6-version;-&imagemagick6-patch-version;</title>
65
66 <indexterm zone="imagemagick6">
67 <primary sortas="a-ImageMagick-6 libraries">ImageMagick-6 libraries</primary>
68 </indexterm>
69
70 <sect2 role="package">
71 <title>Introduction to ImageMagick-6 libraries</title>
72
73 <para>
74 <application>ImageMagick</application> underwent many changes in its
75 libraries between versions 6 and 7. Most packages in BLFS which use
76 <application>ImageMagick</application> can use version 7, but for the
77 others this page will install only the libraries, headers and general
78 documentation (not programs, manpages, perl modules), and it will
79 rename the unversioned pkgconfig files so that they do not overwrite the
80 same-named files from version 7.
81 </para>
82
83 &lfs91_checked;
84
85 <bridgehead renderas="sect3">Package Information</bridgehead>
86 <itemizedlist spacing="compact">
87 <listitem>
88 <para>
89 Download (HTTP): <ulink url="&imagemagick6-download-http;"/>
90 </para>
91 </listitem>
92 <listitem>
93 <para>
94 Download (FTP): <ulink url="&imagemagick6-download-ftp;"/>
95 </para>
96 </listitem>
97 <listitem>
98 <para>
99 Download MD5 sum: &imagemagick6-md5sum;
100 </para>
101 </listitem>
102 <listitem>
103 <para>
104 Download size: &imagemagick6-size;
105 </para>
106 </listitem>
107 <listitem>
108 <para>
109 Estimated disk space required: &imagemagick6-buildsize;
110 </para>
111 </listitem>
112 <listitem>
113 <para>
114 Estimated build time: &imagemagick6-time;
115 </para>
116 </listitem>
117 </itemizedlist>
118
119 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
120 <itemizedlist spacing="compact">
121 <listitem>
122 <para>
123 Required patch:
124 <ulink url="&patch-root;/ImageMagick-&imagemagick6-version;-&imagemagick6-patch-version;-libs_only-1.patch"/>
125 </para>
126 </listitem>
127 </itemizedlist>
128
129 <note>
130 <para>
131 The <application>ImageMagick</application> source releases are updated
132 frequently and the version shown above may no longer be available from
133 the download locations. You can download a more recent version and use
134 the existing BLFS instructions to install it. Chances are that it will
135 work just fine, but this has not been tested by the BLFS team. If the
136 package version shown above is not available from the locations shown
137 above, or from the <filename class='directory'>legacy/</filename>
138 directory at <literal>ftp.ImageMagick.org/pub/ImageMagick</literal> you
139 can download it from the BLFS package server at Oregon State University:
140 <ulink url="ftp://ftp.osuosl.org/pub/blfs/conglomeration/ImageMagick/"/>.
141 </para>
142 </note>
143
144 <bridgehead renderas="sect3">ImageMagick-6 Dependencies</bridgehead>
145
146 <bridgehead renderas="sect4">Recommended</bridgehead>
147 <para role="recommended">
148 <xref linkend="xorg7-lib"/>
149 </para>
150
151 <para>
152 The optional dependencies listed below should be installed if you need
153 support for the specific format or the conversion tool the dependency
154 provides. Many of the dependencies' capabilities and uses are described in
155 the <quote>MAGICK DELEGATES</quote> section of the
156 <filename>README.txt</filename> file located in the source tree.
157 Additional information about the dependencies can be found in the
158 <filename>Install-unix.txt</filename> file located in the source tree as
159 well as issuing the <command>./configure --help</command> command. A
160 summary of this information, as well as some additional notes can be
161 viewed on-line at <ulink
162 url="http://www.imagemagick.org/script/advanced-unix-installation.php"/>.
163 </para>
164
165 <bridgehead renderas="sect4">Optional System Utilities</bridgehead>
166 <para role="optional">
167 <xref linkend="cups"/>,
168 <xref linkend="curl"/>,
169 <xref linkend="ffmpeg"/>,
170 <xref linkend="fftw"/>,
171 <xref linkend="p7zip"/> (LZMA),
172 <xref linkend="sane"/>,
173 <xref linkend="wget"/>,
174 <xref linkend="xdg-utils"/>,
175 <xref linkend="xterm2"/>,
176 <ulink url="http://dmalloc.com/">Dmalloc</ulink>,
177 <ulink url="http://linux.softpedia.com/get/Programming/Debuggers/Electric-Fence-3305.shtml/">Electric Fence</ulink>,
178 <ulink url="http://www.openpgp.org/about/">PGP</ulink> or
179 <xref linkend="gnupg2"/>
180 (you'll have to do some hacking to use <application>GnuPG</application>),
181 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates">Profiles</ulink>,
182 and
183 <ulink url="http://ufraw.sourceforge.net/">ufraw</ulink> (for raw formats
184 listed in
185 <ulink url="http://imagemagick.org/script/formats.php">
186 http://www.imagemagick.org/www/formats.html</ulink>)
187 </para>
188
189 <bridgehead renderas="sect4">Optional Graphics Libraries</bridgehead>
190 <para role="optional">
191 <xref linkend="jasper"/>,
192 <xref role="nodep" linkend="lcms"/> or
193 <xref linkend="lcms2"/>,
194 <xref linkend="libexif"/>,
195 <xref linkend="libgxps"/>,
196 <xref linkend="libjpeg"/>,
197 <xref linkend="libpng"/>,
198 <xref linkend="libraw"/> (RAW_R),
199 <xref linkend="librsvg"/>,
200 <xref linkend="libtiff"/>,
201 <xref linkend="libwebp"/>,
202 <xref linkend="openjpeg2"/>,
203 <xref linkend="pango"/>,
204 <ulink url="http://djvu.sourceforge.net/">DjVuLibre</ulink>,
205 <ulink url="ftp://ftp.imagemagick.org/pub/ImageMagick/delegates/">
206 FlashPIX (libfpx)</ulink>,
207 <ulink url="https://github.com/FLIF-hub/FLIF/releases">FLIF</ulink>,
208 <ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>,
209 <!-- <ulink url="&gnome-download-http;/libgxps/">libgxps</ulink>, -->
210 <ulink url="https://github.com/HOST-Oman/libraqm/">libraqm</ulink>,
211 <ulink url="http://liblqr.wikidot.com/en:download-page">Liquid Rescale</ulink>,
212 <ulink url="http://www.openexr.com/">OpenEXR</ulink>, and
213 <ulink url="http://www.agocg.ac.uk/train/cgm/ralcgm.htm">RALCGM</ulink>
214 (or <ulink url="http://www.mcmurchy.com/ralcgm/ralcgm-3.51.tar.gz">ralcgm</ulink>)
215 </para>
216
217 <bridgehead renderas="sect4">Optional Graphics Utilities</bridgehead>
218 <para role="optional">
219 <xref linkend="dejavu-fonts"/>,
220 <xref linkend="gs"/>,
221 <xref linkend="gimp"/>,
222 <xref linkend="graphviz"/>,
223 <xref linkend="inkscape"/>,
224 <ulink url="http://www.blender.org/">Blender</ulink>,
225 <ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>,
226 <ulink url="http://www.ghostscript.com/download/gpcldnld.html">GhostPCL</ulink>,
227 <ulink url="http://www.gnuplot.info/">Gnuplot</ulink>,
228 <ulink url="http://www.povray.org/">POV-Ray</ulink>, and
229 <ulink url="http://www.radiance-online.org/">Radiance</ulink>
230 </para>
231
232 <bridgehead renderas="sect4">Optional Conversion Tools</bridgehead>
233 <para role="optional">
234 <xref linkend="enscript"/>,
235 <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
236 <ulink url="http://autotrace.sourceforge.net/">AutoTrace</ulink>,
237 <ulink url="http://www.lizardtech.com/downloads/category/">
238 GeoExpress Command Line Utilities, AKA MrSID Utilities (binary package)</ulink>,
239 <ulink url="http://www.gnu.org/software/hp2xx/">hp2xx</ulink>,
240 <ulink url="https://fossies.org/linux/www/old/html2ps-1.0b7.tar.gz/">html2ps</ulink>,
241 <ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
242 <ulink url="https://sk1project.net/uc2/">UniConvertor</ulink>, and
243 <ulink url="http://www.cs.utah.edu/gdc/projects/urt/">Utah Raster Toolkit</ulink>
244 (or <ulink url="http://www.mcmurchy.com/urt/urt-3.1b.tar.gz">URT-3.1b</ulink>)
245 </para>
246
247 <para condition="html" role="usernotes">User Notes:
248 <!-- share the main page -->
249 <ulink url="&blfs-wiki;/imagemagick"/></para>
250
251 </sect2>
252
253 <sect2 role="installation">
254 <title>Installation of ImageMagick-6 libraries</title>
255
256 <para>
257 Install <application>ImageMagick</application> by running the following
258 commands:
259 </para>
260
261<screen><userinput>patch -Np1 -i ../ImageMagick-&imagemagick6-version;-&imagemagick6-patch-version;-libs_only-1.patch &amp;&amp;
262autoreconf -fi &amp;&amp;
263./configure --prefix=/usr \
264 --sysconfdir=/etc \
265 --enable-hdri \
266 --with-modules \
267 --disable-static &amp;&amp;
268make</userinput></screen>
269
270 <para>
271 Now, as the <systemitem class="username">root</systemitem> user:
272 </para>
273
274<screen role="root"><userinput>make DOCUMENTATION_PATH=/usr/share/doc/imagemagick-&imagemagick6-version; install-libs-only</userinput></screen>
275
276 <para>
277 To test the installation, issue: <command>make check</command>.
278 <!-- in 6.9.9-9 make check runs tests-validate-* A more
279 comprehensive test is the <application>ImageMagick</application>
280 validation suite. If <command>make check</command> has not been executed,
281 run <command>make tests/validate</command> to compile it. Issue
282 <command>tests/validate 2>&amp;1 | tee validate.log</command> to run the
283 validation suite. The result summary may be obtained with <command>grep
284 "validation suite" validate.log</command>.--> Note that the EPS, PS, and PDF
285 tests require a working <application>Ghostscript</application>. One test
286 in 'make check' needs <quote>Helvetica</quote> from <quote>Ghostscript
287 Standard Fonts</quote>, which are optionally installed in
288 <xref linkend="gs"/> - that test, and one other, might fail, but all the
289 validation can still pass.
290 </para>
291
292 </sect2>
293
294 <sect2 role="commands">
295 <title>Command Explanations</title>
296
297 <para>
298 <command>patch -Np1 -i
299 ../ImageMagick-&imagemagick6-version;-imagemagick6_libs_only-1.patch</command>:
300 Move unversioned pkgconfig files to versioned names and provide an option to
301 only install libraries and associated files.
302 </para>
303
304 <para>
305 <parameter>--enable-hdri</parameter>: Enables building of a
306 high dynamic range version of ImageMagick.
307 </para>
308
309 <para>
310 <parameter>--with-modules</parameter>: Enables support for
311 dynamically loadable modules.
312 </para>
313
314 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
315 href="../../xincludes/static-libraries.xml"/>
316
317 <para>
318 <option>--with-gslib</option>: Enables support to use the
319 <application>Ghostscript</application> shared library.
320 </para>
321
322 <para>
323 <option>--with-rsvg</option>: Enables support to use the
324 <application>librsvg</application> library.
325 </para>
326
327 <para>
328 <option>--with-autotrace</option>: Enables support to use
329 the <application>Autotrace</application> library.
330 </para>
331
332 <para>
333 <option>--with-wmf</option>: Enables support to use the
334 <application>libwmf</application> library.
335 </para>
336
337 <para>
338 <option>--with-gvc</option>: Enables support to use
339 <application>GraphViz</application>.
340 </para>
341
342 <para>
343 <option>--with-windows-font-dir=
344 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
345 This option specifies the directory where the Windows CoreFonts are
346 installed.
347 </para>
348
349 <para>
350 <option>--with-dejavu-font-dir=
351 <replaceable>&lt;Some/Directory&gt;</replaceable></option>:
352 This option specifies the directory where the DejaVu fonts are
353 installed.
354 </para>
355
356 <para>
357 The options and parameters listed above are the only ones you should
358 have to pass to the <command>configure</command> script to activate all
359 the delegate dependencies. All other dependencies will be automatically
360 detected and utilized in the build if they are installed.
361 </para>
362
363 </sect2>
364
365 <sect2 role="content">
366 <title>Contents</title>
367
368 <segmentedlist>
369 <segtitle>Installed Programs</segtitle>
370 <segtitle>Installed Libraries</segtitle>
371 <segtitle>Installed Directories</segtitle>
372
373 <seglistitem>
374 <seg>
375 None
376 </seg>
377 <seg>
378 libMagickCore-6.Q16HDRI.so,
379 libMagickWand-6.Q16HDRI.so and
380 libMagick++-6.Q16HDRI.so
381 </seg>
382 <seg>
383 /etc/ImageMagick-6,
384 /usr/include/ImageMagick-6,
385 /usr/lib/ImageMagick-&imagemagick6-version;,
386 /usr/share/doc/ImageMagick-&imagemagick6-version;, and
387 /usr/share/ImageMagick-6
388 </seg>
389 </seglistitem>
390 </segmentedlist>
391
392 <variablelist>
393 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
394 <?dbfo list-presentation="list"?>
395 <?dbhtml list-presentation="table"?>
396
397 <varlistentry id="libMagickCore-6.Q16HDRI">
398 <term><filename class="libraryfile">libMagickCore-6.Q16HDRI.so</filename></term>
399 <listitem>
400 <para>
401 provides the C API for ImageMagick.
402 </para>
403 <indexterm zone="imagemagick6 libMagickCore-6.Q16HDRI">
404 <primary sortas="c-libMagickCore-6.Q16HDRI">libMagickCore-6.Q16HDRI.so</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 <varlistentry id="libMagickWand-6.Q16HDRI">
410 <term><filename class="libraryfile">libMagickWand-6.Q16HDRI.so</filename></term>
411 <listitem>
412 <para>
413 is the recommended C API for ImageMagick. Unlike the MagickCore API it
414 uses only a few opaque types.
415 </para>
416 <indexterm zone="imagemagick6 libMagickWand-6.Q16HDRI">
417 <primary sortas="c-libMagickWand-6.Q16HDRI">libMagickWand-6.Q16HDRI.so</primary>
418 </indexterm>
419 </listitem>
420 </varlistentry>
421
422 <varlistentry id="libMagickpp-6.Q16HDRI">
423 <term><filename class="libraryfile">libMagick++-6.Q16HDRI.so</filename></term>
424 <listitem>
425 <para>
426 provides the C++ API for ImageMagick.
427 </para>
428 <indexterm zone="imagemagick6 libMagickpp-6.Q16HDRI">
429 <primary sortas="c-libMagick++-6.Q16HDRI">libMagick++-6.Q16HDRI.so</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434 </variablelist>
435
436 </sect2>
437
438</sect1>
Note: See TracBrowser for help on using the repository browser.