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.

Files changed (108) hide show
  1. data/ChangeLog +78 -25
  2. data/README.html +117 -188
  3. data/README.txt +116 -181
  4. data/build_tarball.rake +205 -0
  5. data/doc/comtasks.html +2 -2
  6. data/doc/constants.html +118 -44
  7. data/doc/draw.html +57 -99
  8. data/doc/ex/adaptive_threshold.rb +1 -10
  9. data/doc/ex/add_noise.rb +4 -5
  10. data/doc/ex/axes.rb +1 -1
  11. data/doc/ex/bilevel_channel.rb +2 -13
  12. data/doc/ex/bounding_box.rb +3 -4
  13. data/doc/ex/channel.rb +6 -7
  14. data/doc/ex/clip_path.rb +11 -5
  15. data/doc/ex/color_histogram.rb +8 -20
  16. data/doc/ex/composite_layers.rb +53 -0
  17. data/doc/ex/fill_pattern.rb +26 -0
  18. data/doc/ex/get_multiline_type_metrics.rb +26 -37
  19. data/doc/ex/get_type_metrics.rb +25 -25
  20. data/doc/ex/images/notimplemented.gif +0 -0
  21. data/doc/ex/level.rb +1 -1
  22. data/doc/ex/matte_floodfill.rb +5 -6
  23. data/doc/ex/matte_replace.rb +5 -6
  24. data/doc/ex/negate_channel.rb +0 -10
  25. data/doc/ex/opacity.rb +3 -5
  26. data/doc/ex/polaroid.rb +4 -1
  27. data/doc/ex/posterize.rb +1 -12
  28. data/doc/ex/preview.rb +1 -8
  29. data/doc/ex/radial_blur.rb +1 -11
  30. data/doc/ex/raise.rb +1 -4
  31. data/doc/ex/random_threshold_channel.rb +4 -9
  32. data/doc/ex/sepiatone.rb +2 -9
  33. data/doc/ex/shadow.rb +12 -18
  34. data/doc/ex/sketch.rb +2 -9
  35. data/doc/ex/smile.rb +7 -7
  36. data/doc/ex/splice.rb +3 -10
  37. data/doc/ex/stegano.rb +5 -0
  38. data/doc/ex/threshold.rb +2 -2
  39. data/doc/ex/transpose.rb +1 -8
  40. data/doc/ex/transverse.rb +1 -8
  41. data/doc/ex/trim.rb +1 -2
  42. data/doc/ex/viewex.rb +4 -5
  43. data/doc/ex/vignette.rb +1 -8
  44. data/doc/ex/watermark.rb +1 -0
  45. data/doc/ex/wet_floor.rb +8 -14
  46. data/doc/ilist.html +301 -110
  47. data/doc/image1.html +362 -258
  48. data/doc/image2.html +429 -286
  49. data/doc/image3.html +418 -192
  50. data/doc/imageattrs.html +100 -39
  51. data/doc/imusage.html +26 -21
  52. data/doc/index.html +52 -93
  53. data/doc/info.html +160 -64
  54. data/doc/magick.html +37 -71
  55. data/doc/optequiv.html +155 -61
  56. data/doc/rvg.html +3 -3
  57. data/doc/rvgclip.html +2 -2
  58. data/doc/rvggroup.html +2 -2
  59. data/doc/rvgimage.html +3 -3
  60. data/doc/rvgpattern.html +3 -3
  61. data/doc/rvgshape.html +2 -2
  62. data/doc/rvgstyle.html +2 -2
  63. data/doc/rvgtext.html +2 -2
  64. data/doc/rvgtspan.html +4 -4
  65. data/doc/rvgtut.html +4 -4
  66. data/doc/rvguse.html +3 -3
  67. data/doc/rvgxform.html +2 -2
  68. data/doc/struct.html +26 -29
  69. data/doc/usage.html +99 -48
  70. data/examples/crop_with_gravity.rb +46 -0
  71. data/examples/demo.rb +2 -2
  72. data/examples/histogram.rb +11 -11
  73. data/examples/identify.rb +45 -45
  74. data/examples/spinner.rb +3 -2
  75. data/ext/RMagick/MANIFEST +7 -8
  76. data/ext/RMagick/extconf.rb +242 -0
  77. data/ext/RMagick/rmagick.h +136 -222
  78. data/ext/RMagick/rmdraw.c +226 -229
  79. data/ext/RMagick/rmfill.c +69 -118
  80. data/ext/RMagick/rmilist.c +234 -94
  81. data/ext/RMagick/rmimage.c +1719 -2564
  82. data/ext/RMagick/rminfo.c +433 -619
  83. data/ext/RMagick/rmmain.c +249 -487
  84. data/ext/RMagick/rmutil.c +344 -563
  85. data/lib/RMagick.rb +414 -358
  86. data/lib/rvg/clippath.rb +2 -2
  87. data/lib/rvg/container.rb +2 -2
  88. data/lib/rvg/describable.rb +2 -2
  89. data/lib/rvg/embellishable.rb +2 -2
  90. data/lib/rvg/misc.rb +3 -3
  91. data/lib/rvg/paint.rb +2 -7
  92. data/lib/rvg/pathdata.rb +2 -2
  93. data/lib/rvg/rvg.rb +2 -2
  94. data/lib/rvg/stretchable.rb +2 -14
  95. data/lib/rvg/stylable.rb +2 -2
  96. data/lib/rvg/text.rb +2 -2
  97. data/lib/rvg/transformable.rb +2 -2
  98. data/lib/rvg/units.rb +2 -2
  99. data/{metaconfig.in → metaconfig} +0 -1
  100. data/post-setup.rb +1 -1
  101. data/rmagick.gemspec +6 -9
  102. metadata +41 -49
  103. data/Makefile.in +0 -42
  104. data/configure +0 -12358
  105. data/configure.ac +0 -791
  106. data/ext/RMagick/extconf.rb.in +0 -25
  107. data/ext/RMagick/rmagick_config.h.in +0 -285
  108. data/gem_extconf.rb +0 -42
data/ChangeLog CHANGED
@@ -1,31 +1,85 @@
1
- RMagick 1.15.17
2
- o Detect new ParseSizeGeometry API and compile accordingly (changed in
3
- ImageMagick 6.4.6-9)
4
-
5
- RMagick 1.15.16
6
- o Miscellaneous changes to work with GraphicsMagick 1.3.1
7
-
8
- RMagick 1.15.15
9
- o Fix bug #21897, a bug that causes ImageList#to_blob to abend when certain
10
- corrupt JPEG images are used
11
-
12
- RMagick 1.15.14
13
- o Fix bug #18271, change rvg#width, rvg#height to return user-space
14
- coordinates (bug report by Greg Jarman)
15
- o Miscellaneous changes to work with GraphicsMagick 1.2
16
- o Change clip_path.rb example to produce the same output in GraphicsMagick
17
- and ImageMagick.
18
-
19
- RMagick 1.15.13
20
- o Fix bug #18016, check for InitializeMagick in libMagickCore (bug report
21
- by Dan Gilbert)
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 (available with
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
@@ -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 1.15.17 README</title>
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 1.15.17 README</h1>
9
+ <h1>RMagick 2.0.0 README</h1>
10
10
 
11
- <h2>12/05/08</h2>
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 and GraphicsMagick image processing libraries.</p>
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="&#x6D;&#x61;&#105;&#x6C;&#x74;&#111;:&#114;&#x6D;&#097;&#x67;&#105;&#099;&#x6B;&#x40;&#114;&#x75;b&#121;&#102;&#x6F;&#x72;&#103;&#101;.&#x6F;&#114;&#x67;">&#114;&#x6D;&#097;&#x67;&#105;&#099;&#x6B;&#x40;&#114;&#x75;b&#121;&#102;&#x6F;&#x72;&#103;&#101;.&#x6F;&#114;&#x67;</a></p>
43
+ <p><strong>Email:</strong> <a href="m&#x61;&#105;&#108;t&#111;:&#x72;&#x6D;&#x61;&#x67;&#x69;&#x63;&#107;&#064;ru&#098;&#121;&#102;&#111;&#114;g&#101;&#x2E;&#x6F;&#114;&#103;">&#x72;&#x6D;&#x61;&#x67;&#x69;&#x63;&#107;&#064;ru&#098;&#121;&#102;&#111;&#114;g&#101;&#x2E;&#x6F;&#114;&#103;</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.6.7 or later. You can get Ruby from <a href="http://www.ruby-lang.org">http://www.ruby-lang.org</a>.
53
- RVG requires Ruby 1.8.</p>
54
-
55
- <p>Either <strong>ImageMagick</strong> 6.0.0 or later, or any release of
56
- <strong>GraphicsMagick</strong>. GraphicsMagick is a friendly fork of ImageMagick
57
- 5.5.1. You can get ImageMagick from <a href="http://www.imagemagick.org">http://www.imagemagick.org</a>. You
58
- can get GraphicsMagick from <a href="http://www.graphicsmagick.org">http://www.graphicsmagick.org</a>. ImageMagick
59
- and GraphicsMagick have slightly different capabilities. Please consult
60
- their web sites if you have questions.</p>
61
-
62
- <h2 id="tips">Tips for installing and configuring ImageMagick and GraphicsMagick</h2>
63
-
64
- <p>See <a href="http://rmagick.rubyforge.org/install-faq.html">http://rmagick.rubyforge.org/install-faq.html</a> for the latest version
65
- of these tips.</p>
66
-
67
- <p>If you are installing RMagick by compiling the source code, I strongly
68
- encourage you to install the latest version of ImageMagick or
69
- GraphicsMagick <em>from source</em>. If you have never installed ImageMagick or
70
- GraphicsMagick before, I also strongly encourage you to read the
71
- README.txt file as many times as is necessary for you to understand how to
72
- configure it. ImageMagick and GraphicsMagick are large and complicated
73
- programs and can be difficult to configure. Follow these tips to minimize
74
- the amount of time you'll spend and your frustration level.</p>
75
-
76
- <p><em>Do not</em> simply type <code>./configure</code> and expect the defaults to be correct
77
- for you. Since you are installing ImageMagick/GraphicsMagick to use with
78
- Ruby, consider whether you want to skip ImageMagick's/GraphicMagick's
79
- support for Perl and C++ by using the <code>--without-perl</code> and
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>If the results are not what you wanted, install any missing libraries,
139
- choose new or different options, or whatever it takes, erase the
140
- config.cache file, and re-run <code>configure</code>. Repeat as often as necessary
141
- before moving to the <code>make</code> and <code>make install</code> steps.</p>
110
+ <p>or</p>
111
+
112
+ <pre><code>tar xvjf RMagick-2.0.0-tar.bz2
113
+ </code></pre>
142
114
 
143
- <p>Detailed information about all of ImageMagick's and GraphicsMagick's
144
- configuration options may be found in their README.txt and INSTALL.txt
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
- <h4>Windows Metafile Format</h4>
118
+ <pre><code>ruby setup.rb
119
+ </code></pre>
148
120
 
149
- <p>As noted in the ImageMagick and GraphicsMagick README.txt files, to
150
- support images in the Windows Metafile format, ImageMagick/GraphicsMagick
151
- requires an additional library. Without this library some of the RMagick
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
- <h2 id="install">Installing RMagick</h2>
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
- <p>Installing RMagick is much simpler than installing ImageMagick or
159
- GraphicsMagick. Note that the make step runs all the example programs.
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>./configure --help</code> to see a list of configuration options. In
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>--with-doc-dir=<em>directory</em></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 /home/user/RMagick, specify:</p>
143
+ documentation in /Users/me/RMagick, specify:</p>
177
144
 
178
- <p><code>./configure --with-doc-dir=/home/user/RMagick</code></p>
145
+ <p><code>./configure --doc-dir=/Users/me/RMagick</code></p>
179
146
  </blockquote></li>
180
- <li><p>--enable-allow-example-errors</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 having
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 (or --enable-htmldoc=no)</p>
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 documentation is installed.</p>
194
- </blockquote></li>
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 &lt;configuration options&gt;
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
- <h4>Can't install RMagick. Can't find libMagick or one of the dependent libraries. Check the config.log file for more detailed information.</h4>
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>The message can also refer to "libGraphicsMagick". Typically this message means that one or more of the libraries that Imagemagick/GraphicsMagick depends on hasn't been installed. Examine the config.log file in the installation directory for any error messages. These messages typically contain enough additional information for you to be able to diagnose the problem.</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-1.15.17/lib/RMagick.rb:11:in `require': libMagick.so.0:
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-1.15.17/ext/RMagick/RMagick.so (LoadError)
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 or GraphicsMagick
258
- library is installed in your load path. An easy way to fix this is to define the
259
- directory in the LD_LIBRARY_PATH environment variable. For example, suppose you
260
- installed the GraphicsMagick library libGraphicsMagick.so in /usr/local/lib.
261
- (By default this is where it is installed.) Create the LD_LIBRARY_PATH variable
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-1.15.17/./post-setup.rb failed:
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 or GraphicsMagick, make sure
287
- you're using a release of RMagick that supports that release. Usually I put out
288
- a new release of RMagick with every new release of ImageMagick. It's safe to
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> target will uninstall RMagick completely:</p>
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>make uninstall
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 or GraphicsMagick
309
- installation and configuration. Please report problems with that software
310
- to their respective authors or distributors.</p>
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-2008 by Timothy P. Hunter</p>
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"),