rmagick 1.9.3 → 1.10.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 (62) hide show
  1. data/ChangeLog +18 -0
  2. data/README.html +12 -12
  3. data/README.txt +10 -10
  4. data/configure +728 -367
  5. data/configure.ac +134 -69
  6. data/doc/comtasks.html +11 -3
  7. data/doc/constants.html +162 -40
  8. data/doc/draw.html +2 -2
  9. data/doc/ex/crop_resized.rb +10 -0
  10. data/doc/ex/get_type_metrics.rb +26 -22
  11. data/doc/ex/vignette.rb +19 -0
  12. data/doc/ilist.html +0 -5
  13. data/doc/image1.html +219 -49
  14. data/doc/image2.html +115 -47
  15. data/doc/image3.html +105 -23
  16. data/doc/imageattrs.html +4 -23
  17. data/doc/imusage.html +1 -1
  18. data/doc/index.html +8 -9
  19. data/doc/info.html +23 -3
  20. data/doc/magick.html +1 -1
  21. data/doc/rvg.html +1 -1
  22. data/doc/rvgclip.html +1 -1
  23. data/doc/rvggroup.html +1 -1
  24. data/doc/rvgimage.html +1 -1
  25. data/doc/rvgpattern.html +1 -1
  26. data/doc/rvgshape.html +1 -1
  27. data/doc/rvgstyle.html +1 -1
  28. data/doc/rvgtext.html +3 -3
  29. data/doc/rvgtspan.html +1 -1
  30. data/doc/rvgtut.html +119 -101
  31. data/doc/rvguse.html +1 -1
  32. data/doc/rvgxform.html +1 -1
  33. data/doc/struct.html +17 -11
  34. data/doc/usage.html +22 -4
  35. data/examples/histogram.rb +48 -12
  36. data/examples/spinner.rb +49 -0
  37. data/ext/RMagick/MANIFEST +4 -1
  38. data/ext/RMagick/rmagick.h +62 -33
  39. data/ext/RMagick/rmagick_config.h.in +28 -31
  40. data/ext/RMagick/rmdraw.c +14 -6
  41. data/ext/RMagick/rmfill.c +2 -2
  42. data/ext/RMagick/rmilist.c +8 -36
  43. data/ext/RMagick/rmimage.c +370 -97
  44. data/ext/RMagick/rminfo.c +6 -6
  45. data/ext/RMagick/rmmain.c +114 -25
  46. data/ext/RMagick/rmutil.c +98 -35
  47. data/lib/RMagick.rb +17 -2
  48. data/lib/rvg/clippath.rb +2 -2
  49. data/lib/rvg/container.rb +2 -2
  50. data/lib/rvg/describable.rb +2 -2
  51. data/lib/rvg/embellishable.rb +2 -2
  52. data/lib/rvg/misc.rb +3 -3
  53. data/lib/rvg/paint.rb +2 -2
  54. data/lib/rvg/pathdata.rb +2 -2
  55. data/lib/rvg/rvg.rb +2 -2
  56. data/lib/rvg/stretchable.rb +2 -2
  57. data/lib/rvg/stylable.rb +2 -2
  58. data/lib/rvg/text.rb +2 -2
  59. data/lib/rvg/transformable.rb +2 -2
  60. data/lib/rvg/units.rb +2 -2
  61. data/rmagick.gemspec +1 -1
  62. metadata +362 -353
data/doc/image2.html CHANGED
@@ -4,14 +4,14 @@
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
9
  <title>RMagick: class Image (instance methods, part 2)</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
13
13
  <meta name="Copyright" content=
14
- "Copyright (C) 2005 by Timothy P. Hunter" />
14
+ "Copyright (C) 2006 by Timothy P. Hunter" />
15
15
  <link rel="stylesheet" type="text/css" href="css/doc.css" />
16
16
  <script type="text/javascript" src="scripts/doc.js">
17
17
  </script>
@@ -55,6 +55,9 @@
55
55
 
56
56
  <li><a href="#export_pixels">export_pixels</a></li>
57
57
 
58
+ <li><a href=
59
+ "#export_pixels_to_str">export_pixels_to_str</a></li>
60
+
58
61
  <li><a href="#flip">flip</a></li>
59
62
 
60
63
  <li><a href="#flip_bang">flip!</a></li>
@@ -79,13 +82,13 @@
79
82
 
80
83
  <li><a href=
81
84
  "#get_exif_by_number">get_exif_by_number</a></li>
82
-
83
- <li><a href="#get_pixels">get_pixels</a></li>
84
85
  </ul>
85
86
  </div>
86
87
 
87
88
  <div class="toccol">
88
89
  <ul>
90
+ <li><a href="#get_pixels">get_pixels</a></li>
91
+
89
92
  <li><a href="#gray_q">gray?</a></li>
90
93
 
91
94
  <li><a href=
@@ -264,9 +267,11 @@
264
267
  <h3 id="export_pixels">export_pixels</h3>
265
268
 
266
269
  <p><span class="arg">image</span>.export_pixels(<span class=
267
- "arg">x</span>, <span class="arg">y</span>, <span class=
268
- "arg">columns</span>, <span class="arg">rows</span>,
269
- <span class="arg">map</span>) -&gt; <em>anArray</em></p>
270
+ "arg">x</span>=0, <span class="arg">y</span>=0, <span class=
271
+ "arg">columns</span>=<span class="arg">image</span>.columns,
272
+ <span class="arg">rows</span>=<span class=
273
+ "arg">image</span>.rows, <span class="arg">map</span>="RGB")
274
+ -&gt; <em>anArray</em></p>
270
275
  </div>
271
276
 
272
277
  <div class="desc">
@@ -292,11 +297,12 @@
292
297
 
293
298
  <dt>map</dt>
294
299
 
295
- <dd>A <code>String</code> reflecting the order of the pixel
296
- data. <span class="imquote">It can be any combination or
297
- order of R = red, G = green, B = blue, A = alpha, C = cyan, Y
298
- = yellow, M = magenta, K = black, or I = intensity (for
299
- grayscale).</span></dd>
300
+ <dd>A string that describes which pixel channel data is
301
+ desired and the order in which it should be stored.
302
+ <span class="imquote">It can be any combination or order of R
303
+ = red, G = green, B = blue, A = alpha, C = cyan, Y = yellow,
304
+ M = magenta, K = black, I = intensity (for grayscale), or P =
305
+ pad.</span></dd>
300
306
  </dl>
301
307
 
302
308
  <h4>Returns</h4>An array
@@ -310,6 +316,7 @@ scanline = img.export_pixels(0, r, img.columns, 1, "RGB");
310
316
  <h4>See also</h4>
311
317
 
312
318
  <p><a href="image1.html#dispatch">dispatch</a>, <a href=
319
+ "#export_pixels_to_str">export_pixels_to_str</a>, <a href=
313
320
  "#import_pixels">import_pixels</a>, <a href=
314
321
  "#get_pixels">get_pixels</a></p>
315
322
 
@@ -322,6 +329,81 @@ scanline = img.export_pixels(0, r, img.columns, 1, "RGB");
322
329
  <p>This method replaces the <code>dispatch</code> method.</p>
323
330
  </div>
324
331
 
332
+ <div class="sig">
333
+ <h3 id="export_pixels_to_str">export_pixels_to_str</h3>
334
+
335
+ <p><span class=
336
+ "arg">image</span>.export_pixels_to_str(<span class=
337
+ "arg">x</span>=0, <span class="arg">y</span>=0, <span class=
338
+ "arg">columns</span>=<span class="arg">image</span>.columns,
339
+ <span class="arg">rows</span>=<span class=
340
+ "arg">image</span>.rows, <span class="arg">map</span>="RGB",
341
+ <span class="arg">type</span>=<code>Magick::CharPixel</code>)
342
+ -&gt; <em>aString</em></p>
343
+ </div>
344
+
345
+ <div class="desc">
346
+ <h4>Description</h4>
347
+
348
+ <p>Extracts the pixel data from the specified rectangle and
349
+ returns it as a string. If you need to get the pixel data in a
350
+ memory buffer (as input to another application, for example),
351
+ this method is much, much faster than <a href=
352
+ "#export_pixels">export_pixels</a> or <a href=
353
+ "#get_pixels">get_pixels</a>.</p>
354
+
355
+ <p>The string returned by <code>export_pixels_to_str</code> is
356
+ suitable for use as an argument to
357
+ <code>import_pixels</code>.</p>
358
+
359
+ <p><strong>Note:</strong> You can also use <a href=
360
+ "image3.html#to_blob">to_blob</a> to convert an image into a
361
+ string.</p>
362
+
363
+ <h4>Arguments</h4>
364
+
365
+ <dl>
366
+ <dt>x, y</dt>
367
+
368
+ <dd>The offset of the rectangle from the upper-left corner of
369
+ the image.</dd>
370
+
371
+ <dt>columns, rows</dt>
372
+
373
+ <dd>The width and height of the rectangle.</dd>
374
+
375
+ <dt>map</dt>
376
+
377
+ <dd>A string that describes which pixel channel data is
378
+ desired and the order in which it should be stored.
379
+ <span class="imquote">It can be any combination or order of R
380
+ = red, G = green, B = blue, A = alpha, C = cyan, Y = yellow,
381
+ M = magenta, K = black, I = intensity (for grayscale), or P =
382
+ pad.</span></dd>
383
+
384
+ <dt>type</dt>
385
+
386
+ <dd>A <a href="constants.html#StorageType">StorageType</a>
387
+ value that specifies the C datatype to which the pixel data
388
+ will be converted. The default is <code>CharPixel</code>,
389
+ which means that the pixel values will be stored as C
390
+ <code>unsigned char</code>s.</dd>
391
+ </dl>
392
+
393
+ <h4>Returns</h4>A string
394
+
395
+ <h4>See also</h4>
396
+
397
+ <p><a href="image1.html#dispatch">dispatch</a>, <a href=
398
+ "#export_pixels">export_pixels</a>, <a href=
399
+ "#import_pixels">import_pixels</a>, <a href=
400
+ "#get_pixels">get_pixels</a></p>
401
+
402
+ <h4>Magick API</h4>
403
+
404
+ <p>ExportImagePixels</p>
405
+ </div>
406
+
325
407
  <div class="sig">
326
408
  <h3 id="flip">flip</h3>
327
409
 
@@ -488,13 +570,14 @@ scanline = img.export_pixels(0, r, img.columns, 1, "RGB");
488
570
  <img style="padding:25px; display:none" id="frameless"
489
571
  onmouseout="this.style.display='none';framed.style.display='';"
490
572
  src="ex/images/Flower_Hat.jpg" alt="frame example" title=
491
- "Click to see the example script" /><!--
573
+ "Click to see the example script" /><!--
492
574
  This img tag displays the framed image when the mouse is not over
493
- --><img class="hide"
494
- id="framed" onmouseover=
575
+ --><img id="framed"
576
+ onmouseover=
495
577
  "this.style.display='none';frameless.style.display='';" src=
496
- "ex/frame.jpg" alt="frame example" /></a> <img src=
497
- "ex/images/spin.gif" alt="" style="margin-bottom: 280px" title=
578
+ "ex/frame.jpg" alt="frame example" /></a>
579
+ <img src="ex/images/spin.gif" alt="" style=
580
+ "margin-bottom: 280px" title=
498
581
  "Mouse over the example to see the original image" /></p>
499
582
 
500
583
  <h4>See also</h4>
@@ -1039,33 +1122,9 @@ image.get_exif_by_number() &raquo;
1039
1122
 
1040
1123
  <dt>type</dt>
1041
1124
 
1042
- <dd>
1043
- Specifies the type and range of the pixel data when
1044
- <span class="arg">pixels</span> is a string. One of the
1045
- following constants:
1046
-
1047
- <dl>
1048
- <dt>CharPixel</dt>
1049
-
1050
- <dd>type <code>unsigned char</code>, range 0-255</dd>
1051
-
1052
- <dt>ShortPixel</dt>
1053
-
1054
- <dd>type <code>unsigned short</code>, range 0-65535</dd>
1055
-
1056
- <dt>LongPixel, IntegerPixel</dt>
1057
-
1058
- <dd>type <code>unsigned long</code>, range
1059
- 0-4294967295</dd>
1060
-
1061
- <dt>QuantumPixel</dt>
1062
-
1063
- <dd>the Quantum type used by &times;Magick (depends on
1064
- how &times;Magick is configured) range 0-MaxRGB</dd>
1065
- </dl>The default is <code>Magick::CharPixel</code>. This
1066
- argument is ignored when <span class="arg">pixels</span> is
1067
- an array.
1068
- </dd>
1125
+ <dd>A <a href="constants.html#StorageType">StorageType</a>
1126
+ value that specifies the type and range of the pixel data
1127
+ when <span class="arg">pixels</span> is a string.</dd>
1069
1128
  </dl>
1070
1129
 
1071
1130
  <h4>Returns</h4>
@@ -2115,8 +2174,8 @@ f.inspect &raquo; "images/Flower_Hat.jpg JPEG 200x250 DirectClass 8-bit 9kb"
2115
2174
  <div class="sig">
2116
2175
  <h3 id="ordered_dither">ordered_dither</h3>
2117
2176
 
2118
- <p><span class="arg">image</span>.ordered_dither -&gt;
2119
- <em>anImage</em></p>
2177
+ <p><span class="arg">image</span>.ordered_dither(<span class=
2178
+ "arg">order</span>=2) -&gt; <em>anImage</em></p>
2120
2179
  </div>
2121
2180
 
2122
2181
  <div class="desc">
@@ -2126,6 +2185,15 @@ f.inspect &raquo; "images/Flower_Hat.jpg JPEG 200x250 DirectClass 8-bit 9kb"
2126
2185
  reducing color images to monochrome using positional
2127
2186
  information to retain as much information as possible.</p>
2128
2187
 
2188
+ <h4>Arguments</h4>
2189
+
2190
+ <dl>
2191
+ <dt>order</dt>
2192
+
2193
+ <dd>The dither order. Must be one of the integers 2, 3, or
2194
+ 4.</dd>
2195
+ </dl>
2196
+
2129
2197
  <h4>Returns</h4>
2130
2198
 
2131
2199
  <p>A new image</p>
@@ -2148,7 +2216,7 @@ f.inspect &raquo; "images/Flower_Hat.jpg JPEG 200x250 DirectClass 8-bit 9kb"
2148
2216
 
2149
2217
  <h4>Magick API</h4>
2150
2218
 
2151
- <p>OrderedDitherImage</p>
2219
+ <p>RandomThresholdImageChannel</p>
2152
2220
  </div>
2153
2221
 
2154
2222
  <div class="sig">
data/doc/image3.html CHANGED
@@ -4,14 +4,14 @@
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
9
  <title>RMagick: class Image (instance methods, part 3)</title>
10
10
  <meta http-equiv="Content-Type" content=
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
13
13
  <meta name="Copyright" content=
14
- "Copyright (C) 2005 by Timothy P. Hunter" />
14
+ "Copyright (C) 2006 by Timothy P. Hunter" />
15
15
  <link rel="stylesheet" type="text/css" href="css/doc.css" />
16
16
  <script type="text/javascript" src="scripts/doc.js">
17
17
  </script>
@@ -149,13 +149,13 @@
149
149
  <li><a href="#stegano">stegano</a></li>
150
150
 
151
151
  <li><a href="#stereo">stereo</a></li>
152
+
153
+ <li><a href="#store_pixels">store_pixels</a></li>
152
154
  </ul>
153
155
  </div>
154
156
 
155
157
  <div class="toccol">
156
158
  <ul>
157
- <li><a href="#store_pixels">store_pixels</a></li>
158
-
159
159
  <li><a href="#strip_bang">strip!</a></li>
160
160
 
161
161
  <li><a href="#swirl">swirl</a></li>
@@ -189,6 +189,8 @@
189
189
 
190
190
  <li><a href="#view">view</a></li>
191
191
 
192
+ <li><a href="#vignette">vignette</a></li>
193
+
192
194
  <li><a href="#wave">wave</a></li>
193
195
 
194
196
  <li><a href="#white_threshold">white_threshold</a></li>
@@ -536,7 +538,7 @@
536
538
  <dt>channel</dt>
537
539
 
538
540
  <dd>A <a href="constants.html#ChannelType">ChannelType</a>
539
- constant. The default is to operate on all channels.</dd>
541
+ value. The default is to operate on all channels.</dd>
540
542
  </dl>
541
543
 
542
544
  <h4>Returns</h4>
@@ -965,14 +967,15 @@ random_threshold_channel(geom, RedChannel)
965
967
  id="notrotated" onmouseout=
966
968
  "this.style.display='none'; rotated.style.display='';" src=
967
969
  "ex/images/Flower_Hat.jpg" alt="rotate example" title=
968
- "Click to see the example script" /><!--
970
+ "Click to see the example script" /><!--
969
971
  This img tag displays the rotated image.
970
972
  --><img class="hide"
971
973
  id="rotated" onmouseover=
972
974
  "this.style.display='none'; notrotated.style.display='';" src=
973
- "ex/rotate_f.jpg" alt="rotate example" /></a> <img src=
974
- "ex/images/spin.gif" alt="" class="spin" style="left:322px;"
975
- title="Mouse over the example to see the original image" /></p>
975
+ "ex/rotate_f.jpg" alt="rotate example" /></a>
976
+ <img src="ex/images/spin.gif" alt="" class="spin" style=
977
+ "left:322px;" title=
978
+ "Mouse over the example to see the original image" /></p>
976
979
 
977
980
  <h4>See also</h4>
978
981
 
@@ -1165,7 +1168,7 @@ random_threshold_channel(geom, RedChannel)
1165
1168
 
1166
1169
  <dd>A <a href=
1167
1170
  "constants.html#ColorspaceType"><code>ColorspaceType</code></a>
1168
- constant. <span class="imquote">Empirical evidence suggests
1171
+ value. <span class="imquote">Empirical evidence suggests
1169
1172
  that distances in YUV or YIQ correspond to perceptual color
1170
1173
  differences more closely than do distances in RGB space. The
1171
1174
  image is then returned to RGB colorspace after color
@@ -1411,13 +1414,14 @@ random_threshold_channel(geom, RedChannel)
1411
1414
  onmouseout=
1412
1415
  "this.style.display='none';shadowed.style.display='';" src=
1413
1416
  "ex/shadow_before.gif" alt="shadow example" title=
1414
- "Click to see the example script" /><!--
1417
+ "Click to see the example script" /><!--
1415
1418
  This img tag displays the shadowed image when the mouse is not over
1416
1419
  --><img class="hide"
1417
1420
  id="shadowed" onmouseover=
1418
1421
  "this.style.display='none';shadowless.style.display='';" src=
1419
- "ex/shadow_after.gif" alt="shadow example" /></a> <img src=
1420
- "ex/images/spin.gif" alt="" style="margin-bottom: 120px" title=
1422
+ "ex/shadow_after.gif" alt="shadow example"
1423
+ /></a> <img src="ex/images/spin.gif" alt="" style=
1424
+ "margin-bottom: 120px" title=
1421
1425
  "Mouse over the example to see the original image" /></p>
1422
1426
 
1423
1427
  <h4>Magick API</h4>
@@ -1628,14 +1632,14 @@ random_threshold_channel(geom, RedChannel)
1628
1632
  id="noshear" onmouseout=
1629
1633
  "this.style.display='none'; sheared.style.display='';" src=
1630
1634
  "ex/images/Flower_Hat.jpg" alt="shear example" title=
1631
- "Click to see the example script" /> <!--
1635
+ "Click to see the example script" /> <!--
1632
1636
  This img tag displays the sheared image when the mouse is not over
1633
1637
  -->
1634
1638
  <img id="sheared" onmouseover=
1635
1639
  "this.style.display='none'; noshear.style.display='';" src=
1636
- "ex/shear.jpg" alt="shear example" /></a><img src=
1637
- "ex/images/spin.gif" alt="" class="spin" style=
1638
- "left: 253px; top: 34px" title=
1640
+ "ex/shear.jpg" alt="shear example"
1641
+ /></a><img src="ex/images/spin.gif" alt="" class=
1642
+ "spin" style="left: 253px; top: 34px" title=
1639
1643
  "Mouse over the example to see the original image" /></p>
1640
1644
 
1641
1645
  <h4>See also</h4>
@@ -1843,13 +1847,14 @@ img.properties &raquo;
1843
1847
  id="nosplice" onmouseout=
1844
1848
  "this.style.display='none';spliced.style.display='';" src=
1845
1849
  "ex/images/Flower_Hat.jpg" alt="splice example" title=
1846
- "Click to see the example script" /><!--
1850
+ "Click to see the example script" /><!--
1847
1851
  This img tag displays the spliced image when the mouse is not over
1848
1852
  --><img class="hide"
1849
1853
  id="spliced" onmouseover=
1850
1854
  "this.style.display='none';nosplice.style.display='';" src=
1851
- "ex/splice.jpg" alt="splice example" /></a> <img src=
1852
- "ex/images/spin.gif" alt="" style="margin-bottom: 280px" title=
1855
+ "ex/splice.jpg" alt="splice example" /></a>
1856
+ <img src="ex/images/spin.gif" alt="" style=
1857
+ "margin-bottom: 280px" title=
1853
1858
  "Mouse over the example to see the original image" /></p>
1854
1859
 
1855
1860
  <h4>See also</h4>
@@ -2558,7 +2563,7 @@ img.to_color(pixel)
2558
2563
  <dt>opacity</dt>
2559
2564
 
2560
2565
  <dd>The new opacity value, either an <a href=
2561
- "constants.html#Opacity">opacity</a> constant or a number
2566
+ "constants.html#Opacity">opacity</a> value or a number
2562
2567
  between 0 and MaxRGB. The default is TransparentOpacity.</dd>
2563
2568
  </dl>
2564
2569
 
@@ -2898,6 +2903,82 @@ end
2898
2903
  control.</p>
2899
2904
  </div>
2900
2905
 
2906
+ <div class="sig">
2907
+ <h3 id="vignette">vignette</h3>
2908
+
2909
+ <p>image.vignette(<span class="arg">x</span>, <span class=
2910
+ "arg">y</span>, <span class="arg">radius</span>=0.0,
2911
+ <span class="arg">sigma</span>=10.0) -&gt; <span class=
2912
+ "arg">anImage</span></p>
2913
+ </div>
2914
+
2915
+ <div class="desc">
2916
+ <h4>Description</h4>
2917
+
2918
+ <p>Gradually shades the edges of the image by transforming the
2919
+ pixels into the background color.</p>
2920
+
2921
+ <h4>Arguments</h4>
2922
+
2923
+ <dl>
2924
+ <dt>x</dt>
2925
+
2926
+ <dd>Influences the amount of background color in the
2927
+ horizontal dimension. Larger values of <span class=
2928
+ "arg">x</span> make the vignette narrower. This argument
2929
+ should be positive and less than image.columns / 2. This
2930
+ argument is optional. If omitted, the default value is 0.10 *
2931
+ <span class="arg">image</span>.columns.</dd>
2932
+
2933
+ <dt>y</dt>
2934
+
2935
+ <dd>Influences the amount of background color in the vertical
2936
+ dimension. Larger values of <span class="arg">y</span> make
2937
+ the vignette shorter. This argument should be positive and
2938
+ less than image.rows / 2. This argument is optional. If
2939
+ omitted, the default value is 0.10 * <span class=
2940
+ "arg">image</span>.rows.</dd>
2941
+
2942
+ <dt>radius, sigma</dt>
2943
+
2944
+ <dd>Controls the amount of blurring. Larger values of
2945
+ <span class="arg">sigma</span> increase the blurring at the
2946
+ expense of increased execution time. In general, <span class=
2947
+ "arg">radius</span> should be larger than <span class=
2948
+ "arg">sigma</span>, although if <span class=
2949
+ "arg">radius</span> is 0 then &times;Magick will choose a
2950
+ suitable value. <span class="arg">Sigma</span> must be
2951
+ non-zero. Choose a very small value for <span class=
2952
+ "arg">sigma</span> to produce a "hard" edge.</dd>
2953
+ </dl>
2954
+
2955
+ <h4>Returns</h4>
2956
+
2957
+ <p>A new image</p>
2958
+
2959
+ <h4>Example</h4>
2960
+
2961
+ <p class="rollover"><a href=
2962
+ "javascript:popup('vignette.rb.html')"><img src=
2963
+ "ex/vignette.jpg" alt="vignette example" title=
2964
+ "Click to see the example script" onmouseover=
2965
+ "this.src='ex/images/Flower_Hat.jpg'" onmouseout=
2966
+ "this.src='ex/vignette.jpg'" /></a> <img src=
2967
+ "ex/images/spin.gif" alt="" class="spin" title=
2968
+ "Mouse over the example to see the original image" /></p>
2969
+
2970
+ <h4>Magick API</h4>
2971
+
2972
+ <p>VignetteImage (available in ImageMagick 6.2.6)</p>
2973
+
2974
+ <h4>Notes</h4>
2975
+
2976
+ <p>The image produced by <code>vignette</code> is very similar
2977
+ to the image produced by RMagick's vignette.rb example script.
2978
+ However, the example script gives you more control over the
2979
+ size, shape, and background color of the vignette.</p>
2980
+ </div>
2981
+
2901
2982
  <div class="sig">
2902
2983
  <h3 id="wave">wave</h3>
2903
2984
 
@@ -2927,12 +3008,13 @@ end
2927
3008
  "padding-top:25px; padding-bottom:25px; display:none" id=
2928
3009
  "nowave" title="Click to see the example script" onmouseout=
2929
3010
  "this.style.display='none'; waved.style.display='';" src=
2930
- "ex/images/Flower_Hat.jpg" alt="wave example" /> <!--
3011
+ "ex/images/Flower_Hat.jpg" alt="wave example" />
3012
+ <!--
2931
3013
  This img tag displays the framed image when the mouse is not over
2932
3014
  --><img class="hide"
2933
3015
  id="waved" onmouseover=
2934
3016
  "this.style.display='none'; nowave.style.display='';" src=
2935
- "ex/wave.jpg" alt="wave example" /></a> <img src=
3017
+ "ex/wave.jpg" alt="wave example" /></a> <img src=
2936
3018
  "ex/images/spin.gif" alt="" class="spin" title=
2937
3019
  "Mouse over the example to see the original image" /></p>
2938
3020