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
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: RVG Class</title>
9
+ <title>RMagick 2.0.0: RVG Reference: RVG Class</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="rvgtut.html">Prev</a> | <a href=
@@ -620,7 +620,7 @@ canvas.background_position = :scaled
620
620
  When the value of the <code>meet_or_slice</code> argument
621
621
  is 'meet' or 'slice', this argument controls the placement
622
622
  of the content within the viewport. The <code>align</code>
623
- argument is the concatenation of an <em>x</em>-alignment and
623
+ argument is the concatenation of an <em>x</em>-aligment and
624
624
  a <em>y</em>-alignment. The values are shown in these
625
625
  lists:
626
626
 
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: RVG::ClipPath Class</title>
9
+ <title>RMagick 2.0.0: RVG Reference: RVG::ClipPath Class</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="rvgpattern.html">Prev</a> | <a href=
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: RVG::Group Class</title>
9
+ <title>RMagick 2.0.0: RVG Reference: RVG::Group Class</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="rvg.html">Prev</a> | <a href=
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: RVG::Image Class</title>
9
+ <title>RMagick 2.0.0: RVG Reference: RVG::Image Class</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="rvggroup.html">Prev</a> | <a href=
@@ -192,7 +192,7 @@
192
192
  When the value of the <code>meet_or_slice</code> argument
193
193
  is 'meet' or 'slice', this argument controls the placement
194
194
  of the image within the viewport. The <code>align</code>
195
- argument is the concatenation of an <em>x</em>-alignment and
195
+ argument is the concatenation of an <em>x</em>-aligment and
196
196
  a <em>y</em>-alignment. The values are shown in these
197
197
  lists:
198
198
 
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: RVG::Pattern Class</title>
9
+ <title>RMagick 2.0.0: RVG Reference: RVG::Pattern Class</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="rvgimage.html">Prev</a> | <a href=
@@ -196,7 +196,7 @@
196
196
  When the value of the <code>meet_or_slice</code> argument
197
197
  is 'meet' or 'slice', this argument controls the placement
198
198
  of the content within the viewport. The <code>align</code>
199
- argument is the concatenation of an <em>x</em>-alignment and
199
+ argument is the concatenation of an <em>x</em>-aligment and
200
200
  a <em>y</em>-alignment. The values are shown in these
201
201
  lists:
202
202
 
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: Shapes</title>
9
+ <title>RMagick 2.0.0: RVG Reference: Shapes</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -28,7 +28,7 @@
28
28
  </head>
29
29
 
30
30
  <body>
31
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
31
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
32
32
 
33
33
  <div class="nav">
34
34
  &laquo;&nbsp;<a href="rvgstyle.html">Prev</a> | <a href=
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: Styles</title>
9
+ <title>RMagick 2.0.0: RVG Reference: Styles</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="rvguse.html">Prev</a> | <a href=
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: RVG::Text Class</title>
9
+ <title>RMagick 2.0.0: RVG Reference: RVG::Text Class</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -33,7 +33,7 @@
33
33
  </head>
34
34
 
35
35
  <body>
36
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
36
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
37
37
 
38
38
  <div class="nav">
39
39
  &laquo;&nbsp;<a href="rvgclip.html">Prev</a> | <a href=
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: RVG::Tspan Class</title>
9
+ <title>RMagick 2.0.0: RVG Reference: RVG::Tspan Class</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="rvgtext.html">Prev</a> | <a href=
@@ -87,7 +87,7 @@
87
87
 
88
88
  <p>Tspan objects are containers, so this method yields to a
89
89
  block if one is present. The only objects that a tspan can
90
- contain are other tspans. Styles defined on a tspan propagate
90
+ contain are other tspans. Styles defined on a tspan propogate
91
91
  to any tspans contained within it.</p>
92
92
 
93
93
  <h4>Arguments</h4>
@@ -206,7 +206,7 @@
206
206
  <p>Calls <a href="#new">RVG::Tspan.new</a> to construct a tspan
207
207
  and adds it to the tspan. Yields to a block if one is present,
208
208
  passing the new tspan as an argument. Styles defined on the
209
- container tspan propagate to the contained tspan.</p>
209
+ container tspan propogate to the contained tspan.</p>
210
210
 
211
211
  <h4>Arguments</h4>
212
212
 
@@ -3,13 +3,13 @@
3
3
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
4
 
5
5
  <html xmlns="http://www.w3.org/1999/xhtml">
6
- <!-- $Id: rvgtut.html,v 1.11.4.1 2008/02/17 14:30:16 rmagick Exp $ -->
6
+ <!-- $Id: rvgtut.html,v 1.11 2007/01/14 19:01:41 rmagick Exp $ -->
7
7
 
8
8
  <head>
9
9
  <meta name="generator" content=
10
10
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
11
11
 
12
- <title>RMagick 1.15.17: RVG Tutorial</title>
12
+ <title>RMagick 2.0.0: RVG Tutorial</title>
13
13
  <meta name="GENERATOR" content="Quanta Plus" />
14
14
  <link rel="stylesheet" type="text/css" href="css/doc.css" />
15
15
  <style type="text/css">
@@ -23,7 +23,7 @@
23
23
  </head>
24
24
 
25
25
  <body>
26
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
26
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
27
27
 
28
28
  <div class="nav">
29
29
  &laquo;&nbsp;<a href="constants.html">Prev</a> | <a href=
@@ -380,7 +380,7 @@
380
380
 
381
381
  <p>In line 16 I define the <code>stroke</code> and
382
382
  <code>stroke_width</code> styles on the group. Styles defined on
383
- the group propagate to shapes within the group unless you
383
+ the group propogate to shapes within the group unless you
384
384
  override them. To do that, call <code>styles</code> on the
385
385
  shapes. In this group each shape has its own fill color. The
386
386
  yellow circle forms the head. The <code>circle</code> method
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: RVG::Use Class</title>
9
+ <title>RMagick 2.0.0: RVG Reference: RVG::Use Class</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="rvgtspan.html">Prev</a> | <a href=
@@ -76,7 +76,7 @@
76
76
  "rvgpattern.html#use">RVG::Pattern</a> classes.</p>
77
77
 
78
78
  <p>The use object is similar to a group. Any styles specified
79
- on the use will propagate to the referenced object. However,
79
+ on the use will propogate to the referenced object. However,
80
80
  styles on the referenced object will override the styles
81
81
  specified on the RVG::Use object.</p>
82
82
 
@@ -6,7 +6,7 @@
6
6
  <meta name="generator" content=
7
7
  "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: RVG Reference: Transforms</title>
9
+ <title>RMagick 2.0.0: RVG Reference: Transforms</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -28,7 +28,7 @@
28
28
  </head>
29
29
 
30
30
  <body>
31
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
31
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
32
32
 
33
33
  <div class="nav">
34
34
  &laquo;&nbsp;<a href="rvgshape.html">Prev</a> | <a href=
@@ -4,9 +4,9 @@
4
4
  <html xmlns="http://www.w3.org/1999/xhtml">
5
5
  <head>
6
6
  <meta name="generator" content=
7
- "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
7
+ "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: Miscellaneous classes</title>
9
+ <title>RMagick 2.0.0: Miscellaneous classes</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -27,7 +27,7 @@
27
27
  </head>
28
28
 
29
29
  <body>
30
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
30
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
31
31
 
32
32
  <div class="nav">
33
33
  &laquo;&nbsp;<a href="draw.html">Prev</a> | <a href=
@@ -90,6 +90,7 @@
90
90
 
91
91
  <ul>
92
92
  <li><a href="#MagickError">ImageMagickError</a></li>
93
+ <li><a href="#DestroyedImageError">DestroyedImageError</a></li>
93
94
  </ul>
94
95
  </div>
95
96
 
@@ -129,7 +130,7 @@
129
130
  <p>The easiest way to use an <code>Image::View</code> object
130
131
  is to create it with the <a href=
131
132
  "image3.html#view">Image#view</a> method, which provides a
132
- block-scoped view and automatic syncing. You probably won't
133
+ block-scoped view and automatic sync'ing. You probably won't
133
134
  want to create a view by calling <code>new</code>.</p>
134
135
 
135
136
  <h5>Arguments</h5>
@@ -221,7 +222,7 @@
221
222
  pixels = view[3][]
222
223
  # Use arrays to specify a non-contiguous set of rows and columns
223
224
  pixels = view[[1,3,5]][[2,4,6]]
224
- # Use ranges to specify a contiguous set of rows and columns
225
+ # Use ranges to specify a contigous set of rows and columns
225
226
  pixels = view[1..5][2..6]
226
227
  </pre>
227
228
  </div>
@@ -326,8 +327,8 @@
326
327
  <h5>Examples</h5>
327
328
  <pre>
328
329
  # Set the red channel of all the pixels in the 2nd
329
- # row of the view to MaxRGB
330
- view[1][].red = MaxRGB
330
+ # row of the view to QuantumRange
331
+ view[1][].red = QuantumRange
331
332
  # Set the green channel of the pixel at [20][30] to
332
333
  # half that of its left-hand neighbor.
333
334
  view[20][30].green = view[20][29].green * 0.5
@@ -413,8 +414,8 @@
413
414
  <h3>Introduction</h3>
414
415
 
415
416
  <p>The Geometry class contains the same information as an
416
- &times;Magick <a href="imusage.html#geometry">geometry
417
- string</a>. Geometry objects are interchangeable with geometry
417
+ ImageMagick <a href="imusage.html#geometry">geometry
418
+ string</a>. Geometry objects are interchangable with geometry
418
419
  strings.</p>
419
420
  </div>
420
421
 
@@ -578,7 +579,7 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
578
579
  <h3>Introduction</h3>
579
580
 
580
581
  <p>A pixel describes the smallest individually addressable
581
- part of an image. In the RGB <a href=
582
+ part of an image. In the RBG <a href=
582
583
  "constants.html#ColorspaceType">colorspace</a>, a pixel's
583
584
  color is described by its intensity in the red, green, and
584
585
  blue channels. Its opacity is described by its intensity in
@@ -586,7 +587,7 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
586
587
  CMYK colorspace a pixel's color is described by its intensity
587
588
  in the cyan, magenta, yellow and black (K) channels.
588
589
  Intensity is a value between 0 and <a href=
589
- "constants.html#MaxRGB">MaxRGB</a>.</p>
590
+ "constants.html#QuantumRange">QuantumRange</a>.</p>
590
591
 
591
592
  <p>Usually, RMagick methods operate on entire images or on
592
593
  groups of pixels that have been selected by their position or
@@ -615,7 +616,7 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
615
616
  <p>Constructs a pixel object from the specified red, green,
616
617
  blue, and opacity intensities. The intensity is a number
617
618
  between 0 and <a href=
618
- "constants.html#Miscellaneous_constants">MaxRGB</a>.</p>
619
+ "constants.html#Miscellaneous_constants">QuantumRange</a>.</p>
619
620
 
620
621
  <h5>Attributes</h5>
621
622
 
@@ -766,7 +767,7 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
766
767
  </div>
767
768
 
768
769
  <div class="sig">
769
- <h4 id="Pixel_to_color">to_color</h4>
770
+ <h4>to_color</h4>
770
771
 
771
772
  <p><span class="arg">pixel</span>.to_color(<span class=
772
773
  "arg">compliance</span>=AllCompliance, <span class=
@@ -803,8 +804,8 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
803
804
  <dt>depth</dt>
804
805
 
805
806
  <dd>An image depth. The default is the quantum depth used
806
- when &times;Magick was compiled. The values 16 and 32 can
807
- be used only when &times;Magick was compiled with the
807
+ when ImageMagick was compiled. The values 16 and 32 can
808
+ be used only when ImageMagick was compiled with the
808
809
  appropriate QuantumDepth.</dd>
809
810
  </dl>
810
811
 
@@ -1249,22 +1250,18 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
1249
1250
  <div class="desc">
1250
1251
  <h4>Description</h4>
1251
1252
 
1252
- <p>When an &times;Magick function returns an error condition,
1253
- RMagick raises an <code>ImageMagickError</code>
1253
+ <p>When an ImageMagick function returns an error condition,
1254
+ RMagick raises this
1254
1255
  exception.</p>
1255
-
1256
- <h4>Attributes</h4>
1257
-
1258
- <dl>
1259
- <dt>magick_location</dt>
1260
-
1261
- <dd>With GraphicsMagick 1.1, this attribute contains a
1262
- string that indicates the source file (module), function
1263
- and line number in which GraphicsMagick raised the error.
1264
- The string is in the form <tt>&lt;function&gt; at
1265
- &lt;module&gt;:&lt;line&gt;</tt>. (Get-only.)</dd>
1266
- </dl>
1267
1256
  </div>
1257
+
1258
+ <h3 id="DestroyedImageError">class DestroyedImageError
1259
+ <span class="superclass">&lt; StandardError</span></h3>
1260
+ <div class="desc">
1261
+ <h4>Description</h4>
1262
+ <p>When any Image method (except <a href="image1.html#destroyed_q">destroyed?</a> and <a href="image2.html#inspect">inspect</a>) is
1263
+ called after an image has been <a href="image1.html#destroy_bang">destroyed</a>, RMagick raises this
1264
+ exception.</p>
1268
1265
  </div>
1269
1266
 
1270
1267
  <p class="spacer">&nbsp;</p>
@@ -4,9 +4,9 @@
4
4
  <html xmlns="http://www.w3.org/1999/xhtml">
5
5
  <head>
6
6
  <meta name="generator" content=
7
- "HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
7
+ "HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
8
8
 
9
- <title>RMagick 1.15.17: How to use RMagick</title>
9
+ <title>RMagick 2.0.0: How to use RMagick</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
@@ -90,7 +90,7 @@
90
90
  </head>
91
91
 
92
92
  <body>
93
- <h6 id="header">RMagick 1.15.17 User's Guide and Reference</h6>
93
+ <h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
94
94
 
95
95
  <div class="nav">
96
96
  &laquo;&nbsp;<a href="index.html">Prev</a> | <a href=
@@ -148,7 +148,7 @@
148
148
  "#rubygems">2</a></span> the RMagick.rb file, which defines the
149
149
  <b>Magick</b> module. The Magick module contains 3 major classes,
150
150
  <b>ImageList</b>, <b>Image</b>, and <b>Draw</b>. This section -
151
- <em>Basic Concepts</em> - describes the ImageList and Image
151
+ <em>Basic Comcepts</em> - describes the ImageList and Image
152
152
  classes. The Draw class is explained in the <em><a href=
153
153
  "#drawing">Drawing on and adding text to images</a></em> section,
154
154
  below.</p>
@@ -231,8 +231,8 @@
231
231
 
232
232
  <p>The statement on line 7 writes the image to a file. Notice
233
233
  that the filename extension is <code>gif</code>. When writing
234
- images, &times;Magick uses the filename extension to determine
235
- what image format to write. In this example, the
234
+ images, ImageMagick uses the filename extension to determine what
235
+ image format to write. In this example, the
236
236
  <code>Small-Cheetah.gif</code> file will be in the GIF format.
237
237
  Notice how easy it is to covert an image from one format to
238
238
  another? (For more details, see <a href=
@@ -377,8 +377,8 @@ exit
377
377
  <p>The methods can be classified into the following broad groups.
378
378
  ImageList method descriptions look like <span class=
379
379
  "ilist">this</span>. Some of the listed methods are not available
380
- in some releases of &times;Magick. See the method documentation
381
- for details.</p>
380
+ in some releases of ImageMagick. See the method documentation for
381
+ details.</p>
382
382
 
383
383
  <div id="index">
384
384
  <h4>Utility methods</h4>
@@ -430,6 +430,11 @@ exit
430
430
  <dd>Return the maximum and minimum intensity values for one
431
431
  or more channels in the image</dd>
432
432
 
433
+ <dt><a href=
434
+ "image1.html#check_destroyed">check_destroyed</a></dt>
435
+
436
+ <dd>Raise an exception if the image has been destroyed</dd>
437
+
433
438
  <dt><a href="image1.html#clone">clone</a></dt>
434
439
 
435
440
  <dd>Return a shallow copy of the image</dd>
@@ -444,6 +449,11 @@ exit
444
449
  <dd>Count the number of times each unique color appears in
445
450
  the image</dd>
446
451
 
452
+ <dt><a href="image1.html#combine">combine</a></dt>
453
+
454
+ <dd>Combines the grayscale value of the pixels in each image
455
+ to form a new image.</dd>
456
+
447
457
  <dt><a href="image1.html#copy">copy</a></dt>
448
458
 
449
459
  <dd>Return a deep copy of the image</dd>
@@ -457,6 +467,15 @@ exit
457
467
 
458
468
  <dd>Delete an ICC, IPTC, or generic profile</dd>
459
469
 
470
+ <dt><a href="image1.html#destroy_bang">destroy!</a></dt>
471
+
472
+ <dd>Return all memory associated with the image to the
473
+ system</dd>
474
+
475
+ <dt><a href="image1.html#destroyed_q">destroyed?</a></dt>
476
+
477
+ <dd>Has the image has been destroyed?</dd>
478
+
460
479
  <dt><a href="image1.html#difference">difference</a></dt>
461
480
 
462
481
  <dd>Compute the difference between two images</dd>
@@ -475,7 +494,11 @@ exit
475
494
 
476
495
  <dd class="ilist">Return a shallow copy of the imagelist</dd>
477
496
 
478
- <dt><a href="image1.html#each_profile">each_profile</a></dt>
497
+ <dt><a href="image2.html#each_pixel">each_pixel</a></dt>
498
+
499
+ <dd>Iterate over all the pixels in the image</dd>
500
+
501
+ <dt><a href="image2.html#each_profile">each_profile</a></dt>
479
502
 
480
503
  <dd>Iterate over all the profiles associated with the
481
504
  image</dd>
@@ -510,6 +533,10 @@ exit
510
533
 
511
534
  <dd>Are all the pixels in the image gray?</dd>
512
535
 
536
+ <dt><a href="image2.html#histogram_q">histogram?</a></dt>
537
+
538
+ <dd>Does the image have &lt;= 1024 unique colors??</dd>
539
+
513
540
  <dt><a href=
514
541
  "image2.html#import_pixels">import_pixels</a></dt>
515
542
 
@@ -525,7 +552,7 @@ exit
525
552
 
526
553
  <dd>Are all the pixels in the image opaque?</dd>
527
554
 
528
- <dt><a href="image2.html#palette_q">palette?</a></dt>
555
+ <dt><a href="image3.html#palette_q">palette?</a></dt>
529
556
 
530
557
  <dd>Is the image a PseudoClass type image with 256 colors or
531
558
  less?</dd>
@@ -545,6 +572,11 @@ exit
545
572
  <dd>Iterate over all the properties associated with the
546
573
  image</dd>
547
574
 
575
+ <dt><a href="image3.html#separate">separate</a></dt>
576
+
577
+ <dd>Construct a grayscale image for each channel
578
+ specified</dd>
579
+
548
580
  <dt><a href=
549
581
  "image3.html#set_channel_depth">set_channel_depth</a></dt>
550
582
 
@@ -554,10 +586,6 @@ exit
554
586
 
555
587
  <dd>Compute the 64-byte message signature for the image</dd>
556
588
 
557
- <dt><a href="image3.html#statistics">statistics</a></dt>
558
-
559
- <dd>Compute image statistics</dd>
560
-
561
589
  <dt><a href="image3.html#store_pixels">store_pixels</a></dt>
562
590
 
563
591
  <dd>Replace a region of pixels in the image</dd>
@@ -566,6 +594,12 @@ exit
566
594
 
567
595
  <dd>Strip the image of all comments and profiles</dd>
568
596
 
597
+ <dt><a href=
598
+ "image3.html#sync_profiles">sync_profiles</a></dt>
599
+
600
+ <dd>Synchronize the image properties with the image
601
+ profiles</dd>
602
+
569
603
  <dt><a href=
570
604
  "image3.html#unique_colors">unique_colors</a></dt>
571
605
 
@@ -585,11 +619,6 @@ exit
585
619
  <dd>Remove duplicate or unused entries in the image's
586
620
  colormap</dd>
587
621
 
588
- <dt><a href=
589
- "image2.html#grayscale_pseudo_class">grayscale_pseudo_class</a></dt>
590
-
591
- <dd>Convert the image to a grayscale PseudoClass image.</dd>
592
-
593
622
  <dt><a href="image2.html#map">map</a></dt>
594
623
 
595
624
  <dd>Replace the colors of the image with the nearest colors
@@ -605,7 +634,7 @@ exit
605
634
 
606
635
  <dd>Dither the image to a predefined pattern</dd>
607
636
 
608
- <dt><a href="image2.html#posterize">posterize</a></dt>
637
+ <dt><a href="image3.html#posterize">posterize</a></dt>
609
638
 
610
639
  <dd>Reduce the number of colors for a "poster" effect</dd>
611
640
 
@@ -731,7 +760,7 @@ exit
731
760
  <dd>Change all pixels from the specified color to a new
732
761
  color</dd>
733
762
 
734
- <dt><a href="image2.html#pixel_color">pixel_color</a></dt>
763
+ <dt><a href="image3.html#pixel_color">pixel_color</a></dt>
735
764
 
736
765
  <dd>Get or set the color of a single pixel</dd>
737
766
 
@@ -819,6 +848,11 @@ exit
819
848
  <dd>Composite the image onto another image as dictated by an
820
849
  affine matrix</dd>
821
850
 
851
+ <dt class="ilist"><a href=
852
+ "ilist.html#composite_layers">composite_layers</a></dt>
853
+
854
+ <dd class="ilist">Composite two imagelists</dd>
855
+
822
856
  <dt><a href="image1.html#displace">displace</a></dt>
823
857
 
824
858
  <dd>Distort the image using a displacement map</dd>
@@ -827,6 +861,10 @@ exit
827
861
 
828
862
  <dd>Dissolve two images into each other</dd>
829
863
 
864
+ <dt><a href="image2.html#extent">extent</a></dt>
865
+
866
+ <dd>Extend or crop the image over the background color.</dd>
867
+
830
868
  <dt><a href="image3.html#watermark">watermark</a></dt>
831
869
 
832
870
  <dd>Composite a watermark onto the image</dd>
@@ -865,6 +903,14 @@ exit
865
903
  that include only the changed pixels between each image and
866
904
  its successor</dd>
867
905
 
906
+ <dt><a href="image1.html#distort">distort</a></dt>
907
+
908
+ <dd>Distort the image</dd>
909
+
910
+ <dt><a href="image2.html#excerpt">excerpt</a></dt>
911
+
912
+ <dd>Excerpt a rectangle from the image</dd>
913
+
868
914
  <dt class="ilist"><a href=
869
915
  "ilist.html#flatten_images">flatten_images</a></dt>
870
916
 
@@ -897,6 +943,11 @@ exit
897
943
  <h4>Enhance</h4>
898
944
 
899
945
  <dl>
946
+ <dt><a href="image1.html#clut_channel">clut_channel</a></dt>
947
+
948
+ <dd>Replace the channel values in the image with a lookup of
949
+ its replacement value in an LUT gradient image.</dd>
950
+
900
951
  <dt><a href="image1.html#contrast">contrast</a></dt>
901
952
 
902
953
  <dd>Enhance the intensity differences between the lighter and
@@ -917,7 +968,8 @@ exit
917
968
  <dd>Apply a digital filter that improves the quality of a
918
969
  noisy image</dd>
919
970
 
920
- <dt><a href="image2.html#equalize">equalize</a></dt>
971
+ <dt><a href="image2.html#equalize">equalize</a>, <a href=
972
+ "image2.html#equalize_channel">equalize_channel</a></dt>
921
973
 
922
974
  <dd>Apply a histogram equalization to the image</dd>
923
975
 
@@ -1070,11 +1122,11 @@ exit
1070
1122
 
1071
1123
  <dd>Add a charcoal effect</dd>
1072
1124
 
1073
- <dt><a href="image1.html#edge">edge</a></dt>
1125
+ <dt><a href="image2.html#edge">edge</a></dt>
1074
1126
 
1075
1127
  <dd>Find edges in the image</dd>
1076
1128
 
1077
- <dt><a href="image1.html#emboss">emboss</a></dt>
1129
+ <dt><a href="image2.html#emboss">emboss</a></dt>
1078
1130
 
1079
1131
  <dd>Add a three-dimensional effect</dd>
1080
1132
 
@@ -1091,7 +1143,7 @@ exit
1091
1143
 
1092
1144
  <dd>Add an oil paint effect</dd>
1093
1145
 
1094
- <dt><a href="image2.html#polaroid">polaroid</a></dt>
1146
+ <dt><a href="image3.html#polaroid">polaroid</a></dt>
1095
1147
 
1096
1148
  <dd>Simulate a Polaroid&reg; instant picture</dd>
1097
1149
 
@@ -1205,7 +1257,7 @@ exit
1205
1257
 
1206
1258
  <p>Image and ImageList objects can be serialized using Ruby's
1207
1259
  <code>Marshal</code> module. Marshaling is supported via
1208
- &times;Magick's Binary Large OBject functions
1260
+ ImageMagick's Binary Large OBject functions
1209
1261
  <code>ImageToBlob</code> (for dumping) and
1210
1262
  <code>BlobToImage</code> (for loading).</p>
1211
1263
 
@@ -1231,7 +1283,7 @@ exit
1231
1283
 
1232
1284
  <h3 id="drawing">Drawing</h3>
1233
1285
 
1234
- <p>&times;Magick supports a set of 2D drawing commands that are
1286
+ <p>ImageMagick supports a set of 2D drawing commands that are
1235
1287
  very similar to the commands and elements defined by the W3C's
1236
1288
  <a href="http://www.w3.org/TR/SVG/index.html#minitoc">Scalable
1237
1289
  Vector Graphics (SVG) 1.1 Specification</a>. In RMagick, each
@@ -1353,11 +1405,11 @@ exit
1353
1405
  <p>Most of the time, you'll want to specify text properties such
1354
1406
  as the font, its size, font styles such as italic, font weights
1355
1407
  such as bold, the fill and stroke color, etc. The Draw class
1356
- defines <a href="draw.html#attributes">attribute
1357
- writers</a> for this purpose. You can set the desired text
1358
- properties by calling the attribute writers before calling
1359
- <code>annotate</code>, or you can call them in an image block
1360
- associated with the <code>annotate</code> call.</p>
1408
+ defines <a href="draw.html">attribute writers</a> for this
1409
+ purpose. You can set the desired text properties by calling the
1410
+ attribute writers before calling <code>annotate</code>, or you
1411
+ can call them in an image block associated with the
1412
+ <code>annotate</code> call.</p>
1361
1413
 
1362
1414
  <p>The following example shows how to use <code>annotate</code>
1363
1415
  to produce this image.</p>
@@ -1408,7 +1460,7 @@ exit
1408
1460
  <p>First, the statements in lines 8-10 create the background. See
1409
1461
  <a href="struct.html#fill"><code>Fill classes</code></a> for
1410
1462
  information about the <code>TextureFill</code> class. The
1411
- "granite:" image format is one of &times;Magick's built-in image
1463
+ "granite:" image format is one of ImageMagick's built-in image
1412
1464
  formats. See <a href="imusage.html#builtin_formats">"Built-in
1413
1465
  image formats"</a> for more information. The statement on line 12
1414
1466
  creates the Draw object that does the annotation. The next 3
@@ -1436,20 +1488,19 @@ exit
1436
1488
 
1437
1489
  <h2 id="more">Where to go from here</h2>
1438
1490
 
1439
- <p>The next section, <a href=
1440
- "imusage.html">"ImageMagick/GraphicsMagick Conventions,"</a>
1441
- describes some conventions that you need to know, such as how
1442
- &times;Magick determines the graphic format of an image file,
1443
- etc. The ImageMagick (www.imagemagick.org) and GraphicsMagick
1444
- (www.graphicsmagick.org) web sites (from which much of the
1445
- information in these pages has been taken) offers a lot of detail
1446
- about &times;Magick. While these web sites don't describe
1447
- RMagick, you can often use the documentation to learn more about
1448
- a RMagick method by reading about the Magick API the method
1449
- calls. (In the Reference section of this document, most of the
1450
- method descriptions include the name of the Magick API that the
1451
- method calls.) Check out the example programs. Almost every one
1452
- of the methods is demonstrated in one of the examples.</p>
1491
+ <p>The next section, <a href="imusage.html">"ImageMagick
1492
+ Conventions,"</a> describes some conventions that you need to
1493
+ know, such as how ImageMagick determines the graphic format of an
1494
+ image file, etc. The ImageMagick (www.imagemagick.org) web site
1495
+ (from which much of the information in these pages has been
1496
+ taken) offers a lot of detail about ImageMagick. While this web
1497
+ sites doesn't describe RMagick, you can often use the
1498
+ documentation to learn more about a RMagick method by reading
1499
+ about the Magick API the method calls. (In the Reference section
1500
+ of this document, most of the method descriptions include the
1501
+ name of the Magick API that the method calls.) Check out the
1502
+ example programs. Almost every one of the methods is demonstrated
1503
+ in one of the examples.</p>
1453
1504
 
1454
1505
  <p>Good luck!</p>
1455
1506
 
@@ -1486,7 +1537,7 @@ exit
1486
1537
  use radians instead of degrees.</p>
1487
1538
  </div>
1488
1539
 
1489
- <p class="spacer"> </p>
1540
+ <p class="spacer"></p>
1490
1541
 
1491
1542
  <div class="nav">
1492
1543
  &laquo; <a href="index.html">Prev</a> | <a href=