source: archive/imagemagick6.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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