rmagick 1.15.17 → 2.0.0
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of rmagick might be problematic. Click here for more details.
- data/ChangeLog +78 -25
- data/README.html +117 -188
- data/README.txt +116 -181
- data/build_tarball.rake +205 -0
- data/doc/comtasks.html +2 -2
- data/doc/constants.html +118 -44
- data/doc/draw.html +57 -99
- data/doc/ex/adaptive_threshold.rb +1 -10
- data/doc/ex/add_noise.rb +4 -5
- data/doc/ex/axes.rb +1 -1
- data/doc/ex/bilevel_channel.rb +2 -13
- data/doc/ex/bounding_box.rb +3 -4
- data/doc/ex/channel.rb +6 -7
- data/doc/ex/clip_path.rb +11 -5
- data/doc/ex/color_histogram.rb +8 -20
- data/doc/ex/composite_layers.rb +53 -0
- data/doc/ex/fill_pattern.rb +26 -0
- data/doc/ex/get_multiline_type_metrics.rb +26 -37
- data/doc/ex/get_type_metrics.rb +25 -25
- data/doc/ex/images/notimplemented.gif +0 -0
- data/doc/ex/level.rb +1 -1
- data/doc/ex/matte_floodfill.rb +5 -6
- data/doc/ex/matte_replace.rb +5 -6
- data/doc/ex/negate_channel.rb +0 -10
- data/doc/ex/opacity.rb +3 -5
- data/doc/ex/polaroid.rb +4 -1
- data/doc/ex/posterize.rb +1 -12
- data/doc/ex/preview.rb +1 -8
- data/doc/ex/radial_blur.rb +1 -11
- data/doc/ex/raise.rb +1 -4
- data/doc/ex/random_threshold_channel.rb +4 -9
- data/doc/ex/sepiatone.rb +2 -9
- data/doc/ex/shadow.rb +12 -18
- data/doc/ex/sketch.rb +2 -9
- data/doc/ex/smile.rb +7 -7
- data/doc/ex/splice.rb +3 -10
- data/doc/ex/stegano.rb +5 -0
- data/doc/ex/threshold.rb +2 -2
- data/doc/ex/transpose.rb +1 -8
- data/doc/ex/transverse.rb +1 -8
- data/doc/ex/trim.rb +1 -2
- data/doc/ex/viewex.rb +4 -5
- data/doc/ex/vignette.rb +1 -8
- data/doc/ex/watermark.rb +1 -0
- data/doc/ex/wet_floor.rb +8 -14
- data/doc/ilist.html +301 -110
- data/doc/image1.html +362 -258
- data/doc/image2.html +429 -286
- data/doc/image3.html +418 -192
- data/doc/imageattrs.html +100 -39
- data/doc/imusage.html +26 -21
- data/doc/index.html +52 -93
- data/doc/info.html +160 -64
- data/doc/magick.html +37 -71
- data/doc/optequiv.html +155 -61
- data/doc/rvg.html +3 -3
- data/doc/rvgclip.html +2 -2
- data/doc/rvggroup.html +2 -2
- data/doc/rvgimage.html +3 -3
- data/doc/rvgpattern.html +3 -3
- data/doc/rvgshape.html +2 -2
- data/doc/rvgstyle.html +2 -2
- data/doc/rvgtext.html +2 -2
- data/doc/rvgtspan.html +4 -4
- data/doc/rvgtut.html +4 -4
- data/doc/rvguse.html +3 -3
- data/doc/rvgxform.html +2 -2
- data/doc/struct.html +26 -29
- data/doc/usage.html +99 -48
- data/examples/crop_with_gravity.rb +46 -0
- data/examples/demo.rb +2 -2
- data/examples/histogram.rb +11 -11
- data/examples/identify.rb +45 -45
- data/examples/spinner.rb +3 -2
- data/ext/RMagick/MANIFEST +7 -8
- data/ext/RMagick/extconf.rb +242 -0
- data/ext/RMagick/rmagick.h +136 -222
- data/ext/RMagick/rmdraw.c +226 -229
- data/ext/RMagick/rmfill.c +69 -118
- data/ext/RMagick/rmilist.c +234 -94
- data/ext/RMagick/rmimage.c +1719 -2564
- data/ext/RMagick/rminfo.c +433 -619
- data/ext/RMagick/rmmain.c +249 -487
- data/ext/RMagick/rmutil.c +344 -563
- data/lib/RMagick.rb +414 -358
- data/lib/rvg/clippath.rb +2 -2
- data/lib/rvg/container.rb +2 -2
- data/lib/rvg/describable.rb +2 -2
- data/lib/rvg/embellishable.rb +2 -2
- data/lib/rvg/misc.rb +3 -3
- data/lib/rvg/paint.rb +2 -7
- data/lib/rvg/pathdata.rb +2 -2
- data/lib/rvg/rvg.rb +2 -2
- data/lib/rvg/stretchable.rb +2 -14
- data/lib/rvg/stylable.rb +2 -2
- data/lib/rvg/text.rb +2 -2
- data/lib/rvg/transformable.rb +2 -2
- data/lib/rvg/units.rb +2 -2
- data/{metaconfig.in → metaconfig} +0 -1
- data/post-setup.rb +1 -1
- data/rmagick.gemspec +6 -9
- metadata +41 -49
- data/Makefile.in +0 -42
- data/configure +0 -12358
- data/configure.ac +0 -791
- data/ext/RMagick/extconf.rb.in +0 -25
- data/ext/RMagick/rmagick_config.h.in +0 -285
- data/gem_extconf.rb +0 -42
data/ChangeLog
CHANGED
@@ -1,31 +1,85 @@
|
|
1
|
-
RMagick
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
1
|
+
RMagick 2.0.0
|
2
|
+
o Replaced configure/make/make install with standard Ruby setup.rb,
|
3
|
+
extconf.rb
|
4
|
+
o Removed support for Ruby earlier than 1.8.2
|
5
|
+
o Removed support for GraphicsMagick. As a result these methods are no
|
6
|
+
longer available: Image#grayscale_pseudo_class, Image#statistics.
|
7
|
+
o Removed support for all releases of ImageMagick earlier than 6.3.0.
|
8
|
+
o Removed deprecated Image#random_channel_threshold. Use
|
9
|
+
Image#random_threshold_channel instead
|
10
|
+
o Removed deprecated Image#channel_threshold. Use
|
11
|
+
Image#random_threshold_channel instead
|
12
|
+
o Removed unecessary Image#montage=
|
13
|
+
o Removed unecessary and undocumented Image#image_type=
|
14
|
+
o Removed deprecated Image::Info#tile_info, tile_info= attributes.
|
15
|
+
o Removed deprecated Image::Info#tile, tile= attributes. Use #extract,
|
16
|
+
#extract= instead
|
17
|
+
o Removed deprecated Image::Info#subimage, subimage= attributes. Use
|
18
|
+
scene, scene= instead
|
19
|
+
o Removed deprecated Image::Info#subrange, subrange= attributes. Use
|
20
|
+
number_scenes, number_scenes= instead
|
21
|
+
o Removed deprecated Magick.set_monitor. Use Image#set_monitor,
|
22
|
+
Image::Info#set_monitor instead
|
23
|
+
o Removed deprecated RunlengthEncodedCompression CompressionType. Use
|
24
|
+
RLECompression instead
|
25
|
+
o Deprecated Image#matte, matte= with ImageMagick 6.3.5 and later
|
26
|
+
o Added Image::Info#stroke=, stroke_width= and undercolor= attributes
|
27
|
+
o Added Image::Info#tile_offset= attribute
|
28
|
+
o Added Draw#fill_pattern= and #stroke_pattern= annotate attributes
|
29
|
+
o Changed Image::Info[] and Image::Info[]= to allow an omitted "format"
|
30
|
+
argument
|
31
|
+
o Added Image#destroy!, destroyed?, check_destroyed methods
|
32
|
+
o Support Image object creation/destruction tracing with the
|
33
|
+
Magick.trace_proc attribute
|
34
|
+
o Added Magick::QuantumRange. Magick::MaxRGB is deprecated.
|
35
|
+
o Added OptimizeTransLayer, RemoveDupsLayer, RemoveZeroLayer,
|
36
|
+
OptimizeImageLayer ImageLayerMethods enum values (available with
|
37
|
+
ImageMagick 6.3.3),
|
38
|
+
MosaicLayer, FlattenLayer (available with ImageMagick 6.3.6)
|
39
|
+
o RMagick works with Q32 version of ImageMagick
|
40
|
+
o Added ChangeMaskCompositeOp, DivideCompositeOp, LinearLightCompositeOp
|
41
|
+
CompositeOperator enum values
|
42
|
+
o Added SplineInterpolatePixel InterpolatePixelMethod enum value
|
43
|
+
o Added DitherVirtualPixelMethod, RandomVirtualPixelMethod,
|
44
|
+
BlackVirtualPixelMethod, GrayVirtualPixelMethod, WhiteVirtualPixelMethod
|
45
|
+
(available with ImageMagick 6.3.5), and MaskVirtualPixelMethod (available
|
46
|
+
with ImageMagick 6.3.3) VirtualPixelMethod enum values
|
47
|
+
o Added GIFInterlace, JPEGInterlace, PNGInterlace Interlace type enum
|
48
|
+
values (available with ImageMagick 6.3.4)
|
49
|
+
o Added SentinelFilter FilterTypes enum value (available in ImageMagick
|
50
|
+
6.3.6)
|
51
|
+
o Added Image.combine
|
52
|
+
o Added Image#separate (available with ImageMagick 6.3.2)
|
53
|
+
o Added Image#distort (available with ImageMagick 6.3.5)
|
54
|
+
o Added Image#each_pixel (thanks to Russell Norris for the suggestion and
|
55
|
+
code)
|
56
|
+
o Added Image#histogram? (available with ImageMagick 6.3.5)
|
57
|
+
o Added Image#sync_profiles (available with ImageMagick 6.3.2)
|
58
|
+
o Added Image#extent (available with ImageMagick 6.3.1)
|
59
|
+
o Added Image#excerpt, Image#excerpt! (available with ImageMagick 6.3.5)
|
60
|
+
o Added Image::Info#attenuate
|
61
|
+
o Added Image#clut_channel (available with ImageMagick 6.3.5)
|
62
|
+
o Feature Request #16264, added ImageList#composite_layers (available with
|
63
|
+
ImageMagick 6.3.3, request from Steve Martocci)
|
64
|
+
o Added Image#alpha= (available with ImageMagick 6.3.5)
|
65
|
+
o Added Image#gravity=
|
66
|
+
o Added Image#equalize_channel (available with ImageMagick 6.3.6)
|
67
|
+
o Added new FilterTypes values KaiserFilter, WelshFilter, ParzenFilter,
|
68
|
+
LagrangeFilter, BohmanFilter, BartlettFilter (available with ImageMagick
|
69
|
+
6.3.6)
|
70
|
+
o Fix bug #10339, Image#trim does not support "reset page information
|
71
|
+
option" (bug report from Nobody)
|
72
|
+
o Renamed RMagick.so to RMagick2.so to prevent confusion between RMagick.rb
|
73
|
+
and RMagick.so
|
74
|
+
o Feature Request #16276, re-organize doc to not split Image method pages
|
75
|
+
in the middle of an initial letter (request from Roy Leban)
|
76
|
+
o Updated for ImageMagick 6.3.7-5
|
77
|
+
o Made changes as necessary to work with current Ruby 1.9.0
|
22
78
|
|
23
79
|
RMagick 1.15.12
|
24
80
|
o Fix bug #16221, starting with ImageMagick 6.3.2, get_exif_by_entry/number
|
25
81
|
returns empty array/hash when no arguments are specified, even though the
|
26
82
|
image has EXIF data (bug report from Paul Clegg)
|
27
|
-
o Fix bug #16449, Image#store_pixels removes opacity channel (bug report
|
28
|
-
from Hans de Graaff)
|
29
83
|
|
30
84
|
RMagick 1.15.11
|
31
85
|
o Fix bug #15887, the x_ and y_resolution attributes don't respect the units
|
@@ -89,8 +143,7 @@ RMagick 1.15.0
|
|
89
143
|
o Added polaroid method to the Image class (available with ImageMagick 6.3.1-6)
|
90
144
|
o Added origin attribute to the Image::Info class (supported by
|
91
145
|
ImageMagick 6.3.1-4 and later)
|
92
|
-
o Added PaletteBilevelMatteType to the ImageType enum
|
93
|
-
ImageMagick 6.2.9)
|
146
|
+
o Added PaletteBilevelMatteType to the ImageType enum
|
94
147
|
o Fix bug #6260, some RVG examples produce all-black GIF images
|
95
148
|
o Fix bug #7034, fix the matte method in the Draw class
|
96
149
|
o Fix bug #7373, default channels should be RGB instead of RGBA
|
data/README.html
CHANGED
@@ -1,26 +1,25 @@
|
|
1
1
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
2
2
|
<html>
|
3
3
|
<head>
|
4
|
-
<title>RMagick
|
4
|
+
<title>RMagick 2.0.0 README</title>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
6
6
|
<meta name="GENERATOR" content="BlueCloth">
|
7
7
|
</head>
|
8
8
|
<body>
|
9
|
-
<h1>RMagick
|
9
|
+
<h1>RMagick 2.0.0 README</h1>
|
10
10
|
|
11
|
-
<h2>12/
|
11
|
+
<h2>12/27/07</h2>
|
12
12
|
|
13
13
|
<h2>Table Of Contents</h2>
|
14
14
|
|
15
15
|
<ul>
|
16
16
|
<li><a href="#intro">Introduction</a></li>
|
17
17
|
<li><a href="#contact">Contact Information</a></li>
|
18
|
+
<li><a href="#new">What's new?</a></li>
|
18
19
|
<li><a href="#prereq">Prerequisites</a></li>
|
19
|
-
<li><a href="#tips">Tips for installing and configuring ImageMagick and GraphicsMagick</a></li>
|
20
20
|
<li><a href="#install">Installing RMagick</a>
|
21
21
|
<ul>
|
22
22
|
<li><a href="#options">Configuration options</a></li>
|
23
|
-
<li><a href="#scripts">Running the configure and make scripts</a></li>
|
24
23
|
</ul></li>
|
25
24
|
<li><a href="#uhoh">Things that can go wrong</a></li>
|
26
25
|
<li><a href="#upgrade">Upgrading</a></li>
|
@@ -35,231 +34,162 @@
|
|
35
34
|
<h2 id="intro">Introduction</h2>
|
36
35
|
|
37
36
|
<p>RMagick is an interface between the Ruby programming language and the
|
38
|
-
ImageMagick
|
37
|
+
ImageMagick image processing library.</p>
|
39
38
|
|
40
39
|
<h2 id="contact">Contact Information</h2>
|
41
40
|
|
42
41
|
<p><strong>Author:</strong> Tim Hunter</p>
|
43
42
|
|
44
|
-
<p><strong>Email:</strong> <a href="&#
|
43
|
+
<p><strong>Email:</strong> <a href="mailto:rmagick@rubyforge.org">rmagick@rubyforge.org</a></p>
|
45
44
|
|
46
45
|
<p><strong>RubyForge:</strong> <a href="http://rubyforge.org/projects/rmagick/">http://rubyforge.org/projects/rmagick/</a></p>
|
47
46
|
|
47
|
+
<h2 id="new">What's new?</h2>
|
48
|
+
|
49
|
+
<p>RMagick 2.0.0 incorporates all changes and bug fixes from RMagick 1.15.12.
|
50
|
+
Additionally,</p>
|
51
|
+
|
52
|
+
<ul>
|
53
|
+
<li>The installation procedure is pure Ruby.</li>
|
54
|
+
<li>The minimum version of Ruby is 1.8.2.</li>
|
55
|
+
<li>The minimum version of ImageMagick is 6.3.0.</li>
|
56
|
+
<li>GraphicsMagick is not supported.</li>
|
57
|
+
<li>The following GraphicsMagick-only methods are no longer available:
|
58
|
+
Image#grayscale_pseudo_class, Image#statistics.</li>
|
59
|
+
<li>The following deprecated methods are no longer available:
|
60
|
+
Image#random_channel_threshold, Image#channel_threshold, Image#montage=,
|
61
|
+
Image#image_type=, Image::Info#tile_info, Image#tile_info=,
|
62
|
+
Image::Info#tile, Image::Info#tile=, Image::Info#subimage, Image::Info#subimage=,
|
63
|
+
Image::Info#subrange, Image::Info#subrange=, Magick.set_monitor.</li>
|
64
|
+
<li>The following methods have been added:
|
65
|
+
Image::Info#stroke=, Image::Info#stroke_width= and Image::Info#undercolor=,
|
66
|
+
Draw#fill_pattern= and Draw#stroke_pattern=, Image#destroy!, Image#destroyed?,
|
67
|
+
Image#check_destroyed, Magick.trace_proc, Image.combine, Image#separate,
|
68
|
+
Image#distort, Image#each_pixel.</li>
|
69
|
+
<li>Magick::MaxRGB is deprecated (but still available). Use Magick::QuantumRange
|
70
|
+
instead.</li>
|
71
|
+
<li>RMagick works with the Q32 version of ImageMagick.</li>
|
72
|
+
</ul>
|
73
|
+
|
74
|
+
<p>Various other minor bug fixes and upgrades.</p>
|
75
|
+
|
48
76
|
<h2 id="prereq">Prerequisites</h2>
|
49
77
|
|
50
78
|
<p><strong>O/S:</strong> Linux, Sun Solaris, Cygwin, FreeBSD, OS X.</p>
|
51
79
|
|
52
|
-
<p><strong>Ruby</strong> 1.
|
53
|
-
|
54
|
-
|
55
|
-
<
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
<p
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
<code>--without-magick-plus-plus</code> options. Doing so will speed up the
|
81
|
-
installation process and save some disk space. You will almost certainly
|
82
|
-
want to specify the <code>--enable-shared</code> and <code>--disable-static</code> options.</p>
|
83
|
-
|
84
|
-
<p>Determine which image formats you are interested in using and make sure
|
85
|
-
that you have installed the libraries that ImageMagick/GraphicsMagick uses
|
86
|
-
to process these formats. ImageMagick and GraphicsMagick use additional
|
87
|
-
libraries to support some image formats. If you do not install those
|
88
|
-
libraries you cannot read and write those image formats. You will need to
|
89
|
-
configure ImageMagick/GraphicsMagick to support the JPG, PNG, TIFF, and
|
90
|
-
WMF formats in order to execute all the RMagick sample programs. See
|
91
|
-
ImageMagick's or GraphicMagick's README.txt file for more information.</p>
|
92
|
-
|
93
|
-
<p>Once you have determined the configuration options you need, run the
|
94
|
-
configure script. When it completes, read the summary output to see if
|
95
|
-
configuration worked the way you expected. Here's an example of the
|
96
|
-
summary output from ImageMagick's configure script. Notice that the
|
97
|
-
result of each option is listed in the "Configured value" column.</p>
|
98
|
-
|
99
|
-
<pre><code> Option Value
|
100
|
-
-------------------------------------------------------------------------
|
101
|
-
Shared libraries --enable-shared=yes yes
|
102
|
-
Static libraries --enable-static=no no
|
103
|
-
Module support --with-modules=yes yes
|
104
|
-
GNU ld --with-gnu-ld=yes yes
|
105
|
-
LZW support --enable-lzw=yes yes
|
106
|
-
Quantum depth --with-quantum-depth=8 8
|
107
|
-
|
108
|
-
Delegate Configuration:
|
109
|
-
BZLIB --with-bzlib=yes yes
|
110
|
-
DPS --with-dps=yes yes
|
111
|
-
FlashPIX --with-fpx=yes no
|
112
|
-
FreeType 2.0 --with-ttf=yes yes
|
113
|
-
Ghostscript None gs (7.07.2)
|
114
|
-
Ghostscript fonts --with-gs-font-dir=default /usr/share/fonts/default/Type1/
|
115
|
-
Ghostscript lib --with-gslib=no no
|
116
|
-
Graphviz --with-dot=yes no
|
117
|
-
JBIG --with-jbig=yes no
|
118
|
-
JPEG v1 --with-jpeg=yes yes
|
119
|
-
JPEG-2000 --with-jp2=yes no
|
120
|
-
LCMS --with-lcms=yes yes
|
121
|
-
Magick++ --with-magick-plus-plus=no no
|
122
|
-
PERL --with-perl=no no
|
123
|
-
PNG --with-png=yes yes
|
124
|
-
TIFF --with-tiff=yes yes
|
125
|
-
Windows fonts --with-windows-font-dir=/mnt/windows/windows/fonts /mnt/windows/windows/fonts/
|
126
|
-
WMF --with-wmf=yes yes
|
127
|
-
X11 --with-x= yes
|
128
|
-
XML --with-xml=yes yes
|
129
|
-
ZLIB --with-zlib=yes yes
|
130
|
-
|
131
|
-
X11 Configuration:
|
132
|
-
X_CFLAGS = -I/usr/X11R6/include
|
133
|
-
X_PRE_LIBS = -lSM -lICE
|
134
|
-
X_LIBS = -L/usr/X11R6/lib
|
135
|
-
X_EXTRA_LIBS =
|
80
|
+
<p><strong>Ruby</strong> 1.8.2 or later. You can get Ruby from <a href="http://www.ruby-lang.org">http://www.ruby-lang.org</a>.</p>
|
81
|
+
|
82
|
+
<p><strong>ImageMagick</strong> 6.3.0 or later. You can get ImageMagick from
|
83
|
+
<a href="http://www.imagemagick.org">http://www.imagemagick.org</a>.</p>
|
84
|
+
|
85
|
+
<h2 id="install">Installation</h2>
|
86
|
+
|
87
|
+
<p>The installation procedure for RMagick 2.0.0 is different from that used
|
88
|
+
in earlier releases. Before installing RMagick, you must install ImageMagick.
|
89
|
+
Complete and up-to-date instructions for installing ImageMagick on Linux,
|
90
|
+
*BSD, and other *nix-type O/S's are available
|
91
|
+
at <a href="http://rmagick.rubyforge.org/install-linux.html">http://rmagick.rubyforge.org/install-linux.html</a>, steps 0, 1, 2.
|
92
|
+
Similarly, instructions for installing ImageMagick using MacPorts
|
93
|
+
on OS X are available at <a href="http://rmagick.rubyforge.org/install-osx.html">http://rmagick.rubyforge.org/install-osx.html</a>,
|
94
|
+
steps 1 and 2. After installing
|
95
|
+
ImageMagick, use the instructions in the next section to install RMagick.</p>
|
96
|
+
|
97
|
+
<h2 id="install">Installing RMagick 2.0.0</h2>
|
98
|
+
|
99
|
+
<p>This release of RMagick uses Minero Aoki's setup.rb script for installation.
|
100
|
+
See the next section for configuration options. Usually you do not need to
|
101
|
+
specify any of these options. You can get more information about setup.rb from
|
102
|
+
his web site <a href="http://i.loveruby.net">http://i.loveruby.net</a></p>
|
103
|
+
|
104
|
+
<p>I assume you've already decompressed the tarball, or you wouldn't be reading
|
105
|
+
this. If you have not decompressed the tarball, do so with this command:</p>
|
106
|
+
|
107
|
+
<pre><code>tar xvzf RMagick-2.0.0-tar.gz
|
136
108
|
</code></pre>
|
137
109
|
|
138
|
-
<p>
|
139
|
-
|
140
|
-
|
141
|
-
|
110
|
+
<p>or</p>
|
111
|
+
|
112
|
+
<pre><code>tar xvjf RMagick-2.0.0-tar.bz2
|
113
|
+
</code></pre>
|
142
114
|
|
143
|
-
<p>
|
144
|
-
configuration options
|
145
|
-
files.</p>
|
115
|
+
<p>Change to the RMagick-2.0.0 directory. If you are not using any
|
116
|
+
configuration options (usually you don't need to) enter the command</p>
|
146
117
|
|
147
|
-
<
|
118
|
+
<pre><code>ruby setup.rb
|
119
|
+
</code></pre>
|
148
120
|
|
149
|
-
<p>
|
150
|
-
|
151
|
-
|
152
|
-
sample programs will not work. ImageMagick and GraphicsMagick require
|
153
|
-
libwmf 0.2.5, 0.2.7, or 0.2.2 to support the WMF format. (Avoid libwmf
|
154
|
-
0.2.6!)</p>
|
121
|
+
<p>Note that setup.rb executes all the example programs, so this can take
|
122
|
+
some time. This process both builds the example images used in the
|
123
|
+
documentation and validates your RMagick installation.</p>
|
155
124
|
|
156
|
-
<
|
125
|
+
<p>After this command completes, make sure you have root priviledges (that
|
126
|
+
is, login as root or use su or sudo) and enter the command</p>
|
157
127
|
|
158
|
-
<
|
159
|
-
|
160
|
-
This process both builds the example images used in the documentation and
|
161
|
-
validates your RMagick installation. This step can take 5-15 minutes
|
162
|
-
depending on the speed of your computer.</p>
|
128
|
+
<pre><code>ruby setup.rb install
|
129
|
+
</code></pre>
|
163
130
|
|
164
131
|
<h4 id="options">Configuration Options</h4>
|
165
132
|
|
166
|
-
<p>Type <code
|
133
|
+
<p>Type <code>ruby setup.rb --help</code> to see a list of configuration options. In
|
167
134
|
addition to the regular options, there are a few RMagick-specific options:</p>
|
168
135
|
|
169
136
|
<ul>
|
170
|
-
<li><p>--
|
137
|
+
<li><p>--doc-dir=<em>directory</em></p>
|
171
138
|
|
172
139
|
<blockquote>
|
173
140
|
<p>Specify the directory to install the RMagick documentation.
|
174
141
|
By default this is $prefix/share/RMagick, where $prefix is the
|
175
142
|
prefix specified by --prefix. For example, to install the
|
176
|
-
documentation in /
|
143
|
+
documentation in /Users/me/RMagick, specify:</p>
|
177
144
|
|
178
|
-
<p><code>./configure --
|
145
|
+
<p><code>./configure --doc-dir=/Users/me/RMagick</code></p>
|
179
146
|
</blockquote></li>
|
180
|
-
<li><p>--
|
147
|
+
<li><p>--allow-example-errors</p>
|
181
148
|
|
182
149
|
<blockquote>
|
183
150
|
<p>Normally the documentation installation terminates if 5 examples fail.
|
184
151
|
If you use this option, the installation does not check for failing
|
185
|
-
examples and will always complete. This option is useful if you're
|
186
|
-
trouble installing RMagick and you want to see all the failing examples.</p>
|
152
|
+
examples and will always complete. This option is useful if you're
|
153
|
+
having trouble installing RMagick and you want to see all the failing examples.</p>
|
187
154
|
</blockquote></li>
|
188
|
-
<li><p>--disable-htmldoc
|
155
|
+
<li><p>--disable-htmldoc</p>
|
189
156
|
|
190
157
|
<blockquote>
|
191
158
|
<p>By default the install process runs all the RMagick example programs
|
192
159
|
and generates HTML versions of all the examples. This option causes
|
193
|
-
the install process to skip this step. No
|
194
|
-
|
195
|
-
<li><p>--with-graphics-magick</p>
|
196
|
-
|
197
|
-
<blockquote>
|
198
|
-
<p>If you have both ImageMagick and GraphicsMagick installed, this option will
|
199
|
-
force RMagick to be configured with GraphicsMagick.</p>
|
200
|
-
</blockquote></li>
|
201
|
-
<li><p>--with-so-dir=<em>directory</em></p>
|
202
|
-
|
203
|
-
<blockquote>
|
204
|
-
<p>The directory for ruby extensions.</p>
|
205
|
-
</blockquote></li>
|
206
|
-
<li><p>--with-ruby-path=<em>directory</em></p>
|
207
|
-
|
208
|
-
<blockquote>
|
209
|
-
<p>The path to set the !# line in Ruby scripts. The default is $prefix/bin/ruby.</p>
|
210
|
-
</blockquote></li>
|
211
|
-
<li><p>--with-ruby-prog=<em>name</em></p>
|
212
|
-
|
213
|
-
<blockquote>
|
214
|
-
<p>The name of the Ruby executable. The default is <code>ruby</code>.</p>
|
215
|
-
</blockquote></li>
|
216
|
-
<li><p>--with-make-prog=<em>name</em></p>
|
217
|
-
|
218
|
-
<blockquote>
|
219
|
-
<p>The name of the <code>make</code> program.</p>
|
220
|
-
</blockquote></li>
|
221
|
-
<li><p>--with-rbconfig=<em>directory</em></p>
|
222
|
-
|
223
|
-
<blockquote>
|
224
|
-
<p>The directory of the rbconfig.rb file to use. The default is Ruby's
|
225
|
-
rbconfig.</p>
|
160
|
+
the install process to skip this step. No install verification occurs
|
161
|
+
and no documentation is installed.</p>
|
226
162
|
</blockquote></li>
|
227
163
|
</ul>
|
228
164
|
|
229
|
-
<h4 id="scripts">Running the <code>configure</code> and <code>make</code> scripts</h4>
|
230
|
-
|
231
|
-
<p>De-compress the RMagick-1.15.17.tar.gz archive and enter the top
|
232
|
-
directory. Then type:</p>
|
233
|
-
|
234
|
-
<pre><code>$ ./configure <configuration options>
|
235
|
-
$ make
|
236
|
-
($ su)
|
237
|
-
$ make install
|
238
|
-
(optionally)
|
239
|
-
$ make clean
|
240
|
-
</code></pre>
|
241
|
-
|
242
165
|
<h2 id="uhoh">Things that can go wrong</h2>
|
243
166
|
|
244
|
-
<
|
167
|
+
<p>The RMagick installation FAQ [<a href="http://rmagick.rubyforge.org/install-faq.html">http://rmagick.rubyforge.org/install-faq.html</a>]
|
168
|
+
has answers to the most commonly reported problems.</p>
|
169
|
+
|
170
|
+
<h4>Can't install RMagick. Can't find libMagick or one of the dependent libraries. Check the mkmf.log file for more detailed information.</h4>
|
245
171
|
|
246
|
-
<p>
|
172
|
+
<p>Typically this message means that one or more of the libraries that ImageMagick
|
173
|
+
depends on hasn't been installed. Examine the mkmf.log file in the ext/RMagick
|
174
|
+
subdirectory of the installation directory for any error messages. These messages
|
175
|
+
typically contain enough additional information for you to be able to diagnose
|
176
|
+
the problem. Also see <a href="http://rmagick.rubyforge.org/install-faq.html#libmagick">http://rmagick.rubyforge.org/install-faq.html#libmagick</a>.</p>
|
247
177
|
|
248
178
|
<h4>Cannot open shared object file</h4>
|
249
179
|
|
250
180
|
<p>When make is running the examples, if you get a message like this:</p>
|
251
181
|
|
252
|
-
<pre><code>/home/you/RMagick-
|
182
|
+
<pre><code>/home/you/RMagick-2.0.0/lib/RMagick.rb:11:in `require': libMagick.so.0:
|
253
183
|
cannot open shared object file: No such file or directory -
|
254
|
-
/home/you/RMagick-
|
184
|
+
/home/you/RMagick-2.0.0/ext/RMagick/RMagick.so (LoadError)
|
255
185
|
</code></pre>
|
256
186
|
|
257
|
-
<p>you probably do not have the directory in which the ImageMagick
|
258
|
-
|
259
|
-
directory in the LD_LIBRARY_PATH environment variable.
|
260
|
-
installed the
|
261
|
-
(By default this is where it is installed.) Create the
|
262
|
-
like this:</p>
|
187
|
+
<p>you probably do not have the directory in which the ImageMagick library
|
188
|
+
is installed in your load path. An easy way to fix this is to define
|
189
|
+
the directory in the LD_LIBRARY_PATH environment variable. For
|
190
|
+
example, suppose you installed the ImageMagick library libMagick.so in
|
191
|
+
/usr/local/lib. (By default this is where it is installed.) Create the
|
192
|
+
LD_LIBRARY_PATH variable like this:</p>
|
263
193
|
|
264
194
|
<pre><code>export LD_LIBRARY_PATH=/usr/local/lib
|
265
195
|
</code></pre>
|
@@ -271,7 +201,7 @@ systems, see the documentation for the dynamic loading facility.</p>
|
|
271
201
|
|
272
202
|
<p>When make is running the examples, if you get a message like this:</p>
|
273
203
|
|
274
|
-
<pre><code>hook /home/me/src/RMagick-
|
204
|
+
<pre><code>hook /home/me/src/RMagick-2.0.0/./post-setup.rb failed:
|
275
205
|
No such file or directory - "/tmp/rmagick6872.6"
|
276
206
|
</code></pre>
|
277
207
|
|
@@ -283,16 +213,16 @@ the TMPDIR environment variable to your temporary directory. For example:</p>
|
|
283
213
|
|
284
214
|
<h2 id="upgrade">Upgrading</h2>
|
285
215
|
|
286
|
-
<p>If you upgrade to a newer release of ImageMagick
|
287
|
-
|
288
|
-
|
289
|
-
install a newer release of RMagick over an earlier release.</p>
|
216
|
+
<p>If you upgrade to a newer release of ImageMagick, make sure you're using a
|
217
|
+
release of RMagick that supports that release. It's safe to install a newer
|
218
|
+
release of RMagick over an earlier release.</p>
|
290
219
|
|
291
220
|
<h2 id="uninstall">Uninstalling</h2>
|
292
221
|
|
293
|
-
<p>The <code>uninstall</code>
|
222
|
+
<p>The <code>uninstall.rb</code> script will uninstall RMagick completely. Make sure you
|
223
|
+
have administrator priviledges. Then run this command:</p>
|
294
224
|
|
295
|
-
<pre><code>
|
225
|
+
<pre><code>ruby uninstall.rb
|
296
226
|
</code></pre>
|
297
227
|
|
298
228
|
<h2 id="samples">More samples</h2>
|
@@ -305,24 +235,23 @@ These programs are not installed in the RMagick documentation tree.</p>
|
|
305
235
|
<p>Please report bugs in RMagick, its documentation, or its installation
|
306
236
|
programs to me via the bug tracker on the <a href="http://rubyforge.org/projects/rmagick">RMagick project page at
|
307
237
|
RubyForge</a>. However, I can't help
|
308
|
-
with Ruby installation and configuration or ImageMagick
|
309
|
-
installation and configuration.
|
310
|
-
|
238
|
+
with Ruby installation and configuration or ImageMagick
|
239
|
+
installation and configuration. Information about reporting problems and
|
240
|
+
getting help for ImageMagick is available at the ImageMagick web site
|
241
|
+
(http://www.imagemagick.org).</p>
|
311
242
|
|
312
243
|
<h2 id="credits">Credits</h2>
|
313
244
|
|
314
245
|
<p>Thanks to</p>
|
315
246
|
|
316
247
|
<ul>
|
317
|
-
<li>Simple Systems, for hosting the RMagick documentation online.</li>
|
318
248
|
<li>ImageMagick Studio LLC, for ImageMagick and for hosting the RMagick documentation.</li>
|
319
|
-
<li>Kaspar Schiess and Brett DiFrischia, for the MS Windows gems.</li>
|
320
249
|
</ul>
|
321
250
|
|
322
251
|
<h2 id="license">License</h2>
|
323
252
|
|
324
253
|
<blockquote>
|
325
|
-
<p>Copyright � 2002-
|
254
|
+
<p>Copyright � 2002-2007 by Timothy P. Hunter</p>
|
326
255
|
|
327
256
|
<p>Permission is hereby granted, free of charge, to any person obtaining a
|
328
257
|
copy of this software and associated documentation files (the "Software"),
|