rmagick 1.7.4 → 1.8.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 (130) hide show
  1. data/ChangeLog +10 -2
  2. data/README.html +284 -290
  3. data/README.txt +298 -307
  4. data/configure +180 -11
  5. data/configure.ac +18 -2
  6. data/doc/comtasks.html +1 -1
  7. data/doc/constants.html +15 -10
  8. data/doc/css/ref.css +67 -0
  9. data/doc/draw.html +1 -1
  10. data/doc/ex/InitialCoords.rb +24 -0
  11. data/doc/ex/NewCoordSys.rb +33 -0
  12. data/doc/ex/OrigCoordSys.rb +19 -0
  13. data/doc/ex/PreserveAspectRatio.rb +206 -0
  14. data/doc/ex/RotateScale.rb +38 -0
  15. data/doc/ex/Skew.rb +39 -0
  16. data/doc/ex/Use01.rb +17 -0
  17. data/doc/ex/Use02.rb +22 -0
  18. data/doc/ex/Use03.rb +17 -0
  19. data/doc/ex/ViewBox.rb +34 -0
  20. data/doc/ex/arcs01.rb +29 -0
  21. data/doc/ex/arcs02.rb +62 -0
  22. data/doc/ex/baseline_shift01.rb +19 -0
  23. data/doc/ex/bounding_box.rb +31 -37
  24. data/doc/ex/circle01.rb +18 -0
  25. data/doc/ex/cubic01.rb +46 -0
  26. data/doc/ex/cubic02.rb +95 -0
  27. data/doc/ex/drop_shadow.rb +1 -1
  28. data/doc/ex/ellipse01.rb +23 -0
  29. data/doc/ex/evenodd.rb +44 -0
  30. data/doc/ex/font_styles.rb +29 -0
  31. data/doc/ex/group.rb +27 -0
  32. data/doc/ex/image.rb +47 -0
  33. data/doc/ex/images/big-duck.gif +0 -0
  34. data/doc/ex/images/duck.gif +0 -0
  35. data/doc/ex/images/duck0.gif +0 -0
  36. data/doc/ex/images/duck1.gif +0 -0
  37. data/doc/ex/images/duck10.gif +0 -0
  38. data/doc/ex/images/duck11.gif +0 -0
  39. data/doc/ex/images/duck12.gif +0 -0
  40. data/doc/ex/images/duck13.gif +0 -0
  41. data/doc/ex/images/duck14.gif +0 -0
  42. data/doc/ex/images/duck15.gif +0 -0
  43. data/doc/ex/images/duck2.gif +0 -0
  44. data/doc/ex/images/duck3.gif +0 -0
  45. data/doc/ex/images/duck4.gif +0 -0
  46. data/doc/ex/images/duck5.gif +0 -0
  47. data/doc/ex/images/duck6.gif +0 -0
  48. data/doc/ex/images/duck7.gif +0 -0
  49. data/doc/ex/images/duck8.gif +0 -0
  50. data/doc/ex/images/duck9.gif +0 -0
  51. data/doc/ex/line01.rb +24 -0
  52. data/doc/ex/nested_rvg.rb +22 -0
  53. data/doc/ex/nonzero.rb +44 -0
  54. data/doc/ex/polygon01.rb +24 -0
  55. data/doc/ex/polyline01.rb +24 -0
  56. data/doc/ex/quad01.rb +37 -0
  57. data/doc/ex/rect01.rb +16 -0
  58. data/doc/ex/rect02.rb +23 -0
  59. data/doc/ex/rvg_clippath.rb +15 -0
  60. data/doc/ex/rvg_linecap.rb +44 -0
  61. data/doc/ex/rvg_linejoin.rb +42 -0
  62. data/doc/ex/rvg_opacity.rb +20 -0
  63. data/doc/ex/rvg_pattern.rb +27 -0
  64. data/doc/ex/rvg_stroke_dasharray.rb +13 -0
  65. data/doc/ex/sepiatone.rb +15 -0
  66. data/doc/ex/shadow.rb +37 -0
  67. data/doc/ex/smile.rb +9 -9
  68. data/doc/ex/stroke_fill.rb +12 -0
  69. data/doc/ex/text01.rb +18 -0
  70. data/doc/ex/text_styles.rb +22 -0
  71. data/doc/ex/texture_fill_to_border.rb +3 -3
  72. data/doc/ex/texture_floodfill.rb +3 -2
  73. data/doc/ex/tref01.rb +26 -0
  74. data/doc/ex/triangle01.rb +17 -0
  75. data/doc/ex/tspan01.rb +19 -0
  76. data/doc/ex/tspan02.rb +20 -0
  77. data/doc/ex/tspan03.rb +22 -0
  78. data/doc/ex/writing_mode01.rb +28 -0
  79. data/doc/ex/writing_mode02.rb +27 -0
  80. data/doc/ilist.html +1 -1
  81. data/doc/image1.html +66 -30
  82. data/doc/image2.html +1 -1
  83. data/doc/image3.html +274 -49
  84. data/doc/imageattrs.html +87 -10
  85. data/doc/imusage.html +1 -1
  86. data/doc/index.html +80 -39
  87. data/doc/info.html +149 -13
  88. data/doc/magick.html +1 -1
  89. data/doc/rvg.html +890 -0
  90. data/doc/rvgclip.html +249 -0
  91. data/doc/rvggroup.html +305 -0
  92. data/doc/rvgimage.html +288 -0
  93. data/doc/rvgpattern.html +456 -0
  94. data/doc/rvgshape.html +376 -0
  95. data/doc/rvgstyle.html +269 -0
  96. data/doc/rvgtext.html +464 -0
  97. data/doc/rvgtspan.html +237 -0
  98. data/doc/rvgtut.html +512 -0
  99. data/doc/rvguse.html +145 -0
  100. data/doc/rvgxform.html +294 -0
  101. data/doc/struct.html +9 -71
  102. data/doc/usage.html +22 -7
  103. data/ext/RMagick/MANIFEST +94 -2
  104. data/ext/RMagick/rmagick.h +10 -4
  105. data/ext/RMagick/rmagick_config.h.in +8 -2
  106. data/ext/RMagick/rmdraw.c +2 -2
  107. data/ext/RMagick/rmfill.c +2 -2
  108. data/ext/RMagick/rmilist.c +3 -3
  109. data/ext/RMagick/rmimage.c +152 -5
  110. data/ext/RMagick/rminfo.c +208 -2
  111. data/ext/RMagick/rmmain.c +14 -5
  112. data/ext/RMagick/rmutil.c +83 -22
  113. data/lib/RMagick.rb +2 -2
  114. data/lib/rvg/clippath.rb +46 -0
  115. data/lib/rvg/container.rb +129 -0
  116. data/lib/rvg/deep_equal.rb +54 -0
  117. data/lib/rvg/describable.rb +51 -0
  118. data/lib/rvg/embellishable.rb +395 -0
  119. data/lib/rvg/misc.rb +729 -0
  120. data/lib/rvg/paint.rb +48 -0
  121. data/lib/rvg/pathdata.rb +129 -0
  122. data/lib/rvg/rvg.rb +279 -0
  123. data/lib/rvg/stretchable.rb +150 -0
  124. data/lib/rvg/stylable.rb +116 -0
  125. data/lib/rvg/text.rb +185 -0
  126. data/lib/rvg/transformable.rb +131 -0
  127. data/lib/rvg/units.rb +64 -0
  128. data/rmagick.gemspec +1 -1
  129. data/uninstall.rb +3 -2
  130. metadata +96 -3
@@ -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 September 2004), 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 (attribute methods)</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) 2004 by Timothy P. Hunter" />
14
+ "Copyright (C) 2005 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>
@@ -78,13 +78,13 @@
78
78
  <li><a href="#compression">compression</a></li>
79
79
 
80
80
  <li><a href="#delay">delay</a></li>
81
+
82
+ <li><a href="#density">density</a></li>
81
83
  </ul>
82
84
  </div>
83
85
 
84
86
  <div class="toccol">
85
87
  <ul>
86
- <li><a href="#density">density</a></li>
87
-
88
88
  <li><a href="#depth">depth</a></li>
89
89
 
90
90
  <li><a href="#directory">directory</a></li>
@@ -119,13 +119,13 @@
119
119
 
120
120
  <li><a href=
121
121
  "#mean_error_per_pixel">mean_error_per_pixel</a></li>
122
+
123
+ <li><a href="#mime_type">mime_type</a></li>
122
124
  </ul>
123
125
  </div>
124
126
 
125
127
  <div class="toccol">
126
128
  <ul>
127
- <li><a href="#mime_type">mime_type</a></li>
128
-
129
129
  <li><a href="#montage">montage</a></li>
130
130
 
131
131
  <li><a href=
@@ -140,8 +140,12 @@
140
140
 
141
141
  <li><a href="#opacity_eq">opacity</a></li>
142
142
 
143
+ <li><a href="#orientation">orientation</a></li>
144
+
143
145
  <li><a href="#page">page</a></li>
144
146
 
147
+ <li><a href="#quality">quality</a></li>
148
+
145
149
  <li><a href="#quantum_depth">quantum_depth</a></li>
146
150
 
147
151
  <li><a href="#rendering_intent">rendering_intent</a></li>
@@ -1089,6 +1093,49 @@
1089
1093
  increase transparency.
1090
1094
  </div>
1091
1095
 
1096
+ <div class="sig">
1097
+ <h3 id="orientation">orientation</h3>
1098
+
1099
+ <p><span class="arg">image</span>.orientation -&gt;
1100
+ <em>anOrientationType</em></p>
1101
+ </div>
1102
+
1103
+ <div class="desc">
1104
+ <h4>Description</h4>
1105
+
1106
+ <p>Returns the value of the Exif Orientation Tag.</p>
1107
+
1108
+ <h4>Returns</h4>
1109
+
1110
+ <p>One of the following OrientationType values:</p>
1111
+
1112
+ <ul>
1113
+ <li>UndefinedOrientation</li>
1114
+
1115
+ <li>TopLeftOrientation</li>
1116
+
1117
+ <li>TopRightOrientation</li>
1118
+
1119
+ <li>BottomRightOrientation</li>
1120
+
1121
+ <li>BottomLeftOrientation</li>
1122
+
1123
+ <li>LeftTopOrientation</li>
1124
+
1125
+ <li>RightTopOrientation</li>
1126
+
1127
+ <li>RightBottomOrientation</li>
1128
+
1129
+ <li>LeftBottomOrientation</li>
1130
+ </ul>
1131
+
1132
+ <h4>Magick API</h4>Available in ImageMagick 6.0.0.
1133
+
1134
+ <h4>Notes</h4>See <a href=
1135
+ "http://jpegclub.org/exif_orientation.html">http://jpegclub.org/exif_orientation.html</a>
1136
+ for more information about the Exif Orientation Tag.
1137
+ </div>
1138
+
1092
1139
  <div class="sig">
1093
1140
  <h3 id="page">page</h3>
1094
1141
 
@@ -1116,6 +1163,30 @@
1116
1163
  <p>A <a href="struct.html#Rectangle">Rectangle</a> object.</p>
1117
1164
  </div>
1118
1165
 
1166
+ <div class="sig">
1167
+ <h3 id="quality">quality</h3>
1168
+
1169
+ <p><span class="arg">image</span>.quality -&gt;
1170
+ <em>aFixnum</em></p>
1171
+ </div>
1172
+
1173
+ <div class="desc">
1174
+ <h4>Description</h4>For JPEG images, returns the Independent
1175
+ JPEG Group quality value. This number is a measurement of the
1176
+ amount of compression used when the image was saved. Lower
1177
+ numbers mean higher compression.
1178
+
1179
+ <h4>Returns</h4>
1180
+
1181
+ <p>A number between 0-100.</p>
1182
+
1183
+ <h4>Notes</h4>
1184
+
1185
+ <p>For more information, see <a href=
1186
+ "http://www.faqs.org/faqs/jpeg-faq/part1/">The JPEG image
1187
+ compression FAQ</a>.</p>
1188
+ </div>
1189
+
1119
1190
  <div class="sig">
1120
1191
  <h3 id="quantum_depth">quantum_depth</h3>
1121
1192
 
@@ -1270,8 +1341,10 @@
1270
1341
  <p>A <a href="constants.html#ResolutionType">ResolutionType</a>
1271
1342
  constant.</p>
1272
1343
 
1273
- <h4>See also</h4><p><a href="#x_resolution">x_resolution</a>,
1274
- <a href="y_resolution">y_resolution</a></p>
1344
+ <h4>See also</h4>
1345
+
1346
+ <p><a href="#x_resolution">x_resolution</a>, <a href=
1347
+ "y_resolution">y_resolution</a></p>
1275
1348
  </div>
1276
1349
 
1277
1350
  <div class="sig">
@@ -1288,7 +1361,9 @@
1288
1361
 
1289
1362
  <p class="imquote">Horizontal resolution of the image.</p>
1290
1363
 
1291
- <h4>See also</h4><p><a href="#units">units</a></p>
1364
+ <h4>See also</h4>
1365
+
1366
+ <p><a href="#units">units</a></p>
1292
1367
  </div>
1293
1368
 
1294
1369
  <div class="sig">
@@ -1305,7 +1380,9 @@
1305
1380
 
1306
1381
  <p class="imquote">Vertical resolution of the image.</p>
1307
1382
 
1308
- <h4>See also</h4><p><a href="#units">units</a></p>
1383
+ <h4>See also</h4>
1384
+
1385
+ <p><a href="#units">units</a></p>
1309
1386
  </div>
1310
1387
 
1311
1388
  <p class="spacer">&nbsp;</p>
@@ -11,7 +11,7 @@
11
11
  "text/html; charset=us-ascii" />
12
12
  <meta name="GENERATOR" content="Quanta Plus" />
13
13
  <meta name="Copyright" content=
14
- "Copyright (C) 2004 by Timothy P. Hunter" />
14
+ "Copyright (C) 2005 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>
@@ -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 September 2004), see www.w3.org" />
7
+ "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
9
  <title>RMagick User's Guide and Reference</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) 2004 by Timothy P. Hunter" />
14
+ "Copyright (C) 2005 by Timothy P. Hunter" />
15
15
  <link rel="stylesheet" type="text/css" href="css/doc.css" />
16
16
  <style type="text/css">
17
17
  /*<![CDATA[*/
@@ -188,6 +188,47 @@
188
188
  <li><a href="constants.html">Constants</a></li>
189
189
  </ul>
190
190
  </li>
191
+
192
+ <li>RVG - Ruby Vector Graphics</li>
193
+
194
+ <li style="list-style:none">
195
+ <ul>
196
+ <li><a href="rvgtut.html">Drawing with RVG: A
197
+ tutorial</a></li>
198
+
199
+ <li>RVG Reference
200
+
201
+ <ul>
202
+ <li><a href="rvg.html">class RVG</a></li>
203
+
204
+ <li><a href="rvggroup.html">class RVG::Group</a></li>
205
+
206
+ <li><a href="rvgimage.html">class RVG::Image</a></li>
207
+
208
+ <li><a href="rvgpattern.html">class
209
+ RVG::Pattern</a></li>
210
+
211
+ <li><a href="rvgclip.html">class
212
+ RVG::ClipPath</a></li>
213
+
214
+ <li><a href="rvgtext.html">class RVG::Text</a></li>
215
+
216
+ <li><a href="rvgtspan.html">class RVG::Tspan</a></li>
217
+
218
+ <li><a href="rvguse.html">class RVG::Use</a></li>
219
+
220
+ <li><a href="rvgstyle.html">The styles
221
+ method</a></li>
222
+
223
+ <li><a href="rvgshape.html">The shapes
224
+ methods</a></li>
225
+
226
+ <li><a href="rvgxform.html">The transform
227
+ methods</a></li>
228
+ </ul>
229
+ </li>
230
+ </ul>
231
+ </li>
191
232
  </ul>
192
233
  </div>
193
234
 
@@ -203,16 +244,13 @@
203
244
 
204
245
  <div class="imquote">
205
246
  <p>ImageMagick<span style=
206
- "font-size: x-small; vertical-align: super">TM</span>...is a
207
- robust collection of tools and libraries...to read, write, and
208
- manipulate an image in many image formats (over 90 major
209
- formats) including popular formats like TIFF, JPEG, PNG, PDF,
210
- PhotoCD, and GIF. With ImageMagick you can create images
211
- dynamically, making it suitable for Web applications. You can
212
- also resize, rotate, sharpen, color reduce, or add special
213
- effects to an image and save your completed work in the same or
214
- differing image format....A high-quality 2D renderer is
215
- included, which provides a subset of SVG capabilities.</p>
247
+ "font-size: x-small; vertical-align: super">TM</span>... is a
248
+ free software suite to create, edit, and compose bitmap images.
249
+ It can read, convert and write images in a large variety of
250
+ formats. Images can be cropped, colors can be changed, various
251
+ effects can be applied, images can be rotated and combined, and
252
+ text, lines, polygons, ellipses and B&eacute;zier curves can be
253
+ added to images and stretched and rotated.</p>
216
254
  </div>
217
255
 
218
256
  <p>GraphicsMagick is a branch from ImageMagick 5.5.2 and provides
@@ -221,20 +259,18 @@
221
259
  this about GraphicsMagick:</p>
222
260
 
223
261
  <div class="imquote">
224
- <p><em>GraphicsMagick</em> is a robust collection of tools and
262
+ <p><em>GraphicsMagick</em> is the swiss army knife of image
263
+ processing. It provides a robust collection of tools and
225
264
  libraries which support reading, writing, and manipulating an
226
- image in over 88 major formats including popular formats like
227
- TIFF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, SVG, and GIF.
228
- <em>GraphicsMagick</em> supports creating new images on the
229
- fly, making it suitable for building dynamic Web applications.
230
- GraphicsMagick may be used to resize, rotate, sharpen, color
231
- reduce, or add special effects to an image and save the result
232
- in the same or differing image format. Image processing
233
- operations are available from the command line, as well as
234
- through C, C++, Perl, Java, or COM programming interfaces.
235
- Extensions are available from third-parties to support
236
- programming in Borland's Delphi, Java, PHP, Python, Scheme, and
237
- Ruby.</p>
265
+ image in over 88 major formats including important formats like
266
+ DPX, GIF, JPEG, JPEG-2000, PNG, PDF, SVG, and TIFF.
267
+ GraphicsMagick supports huge images on systems that support
268
+ large files, and has been tested with gigapixel-size images.
269
+ GraphicsMagick can create new images on the fly, making it
270
+ suitable for building dynamic Web applications. GraphicsMagick
271
+ may be used to resize, rotate, sharpen, color reduce, or add
272
+ special effects to an image and save the result in the same or
273
+ differing image format</p>
238
274
  </div>
239
275
 
240
276
  <p>Both libraries offer a full range of image processing tools
@@ -267,21 +303,26 @@
267
303
  </div>
268
304
 
269
305
  <p>RMagick is a complete interface to ImageMagick and
270
- GraphicsMagick. Within its three major classes and 21 minor
271
- classes RMagick defines over 550 methods and 225 constants.
272
- RMagick exploits Ruby idioms such as blocks and iterators, Struct
273
- classes, symbols, ?- and !-suffixed methods, and exceptions.</p>
306
+ GraphicsMagick. Version 1.0.0 was released in February, 2003.
307
+ Within its four major classes and 30 minor classes RMagick
308
+ defines over 600 methods and 225 constants. RMagick exploits Ruby
309
+ idioms such as blocks and iterators, Struct classes, symbols, ?-
310
+ and !-suffixed methods, and exceptions.</p>
274
311
 
275
312
  <h3>About this document</h3>
276
313
 
277
- <p>This document is divided into 3 parts. The first is this page.
314
+ <p>This document is divided into 4 parts. The first is this page.
278
315
  The second part is a usage guide covering both RMagick and
279
- ImageMagick/GraphicsMagick usage and conventions. The third, and
280
- largest, is the reference guide, which describes all of the
281
- RMagick classes and constants. The reference guide includes many
282
- examples.</p>
316
+ ImageMagick/GraphicsMagick usage and conventions. The third part
317
+ is a reference guide to the ImageList, Image, and Draw classes.
318
+ This guide includes many examples.</p>
319
+
320
+ <p>The fourth part covers the newest addition to RMagick, Ruby
321
+ Vector Graphics (RVG). RVG is a facade for Draw that provides a
322
+ high-level API for scalable vector graphics. The RVG section
323
+ includes a tutorial and complete reference documentation.</p>
283
324
 
284
- <p>Accompanying the HTML documentation is a set of over 130
325
+ <p>Accompanying the HTML documentation is a set of over 175
285
326
  example RMagick programs. Each is a complete, stand-alone program
286
327
  that either creates an image from scratch or modifies an input
287
328
  image using one or more RMagick methods. The output images are
@@ -358,7 +399,7 @@
358
399
  <code>Magick::Long_version</code> constant:</p>
359
400
  <pre class="example" id="version">
360
401
  irb(main):001:0&gt; puts Magick::Long_version
361
- This is RMagick 1.7.0 ($Date: 2004/12/08 12:15:31 $) Copyright (C) 2004 by Timothy P. Hunter
402
+ This is RMagick 1.7.0 ($Date: 2005/04/30 14:43:19 $) Copyright (C) 2004 by Timothy P. Hunter
362
403
  Built with GraphicsMagick 1.1.4 2004-11-13 Q8 http://www.GraphicsMagick.org/
363
404
  Built for ruby 1.8.1 (2003-12-25) [i686-linux]
364
405
  Web page: http://rmagick.rubyforge.org
@@ -397,12 +438,12 @@ Email: rmagick@rubyforge.org
397
438
  Notices</a></h3>
398
439
 
399
440
  <ul>
400
- <li>RMagick is copyright &copy; 2004 by Timothy P. Hunter.</li>
441
+ <li>RMagick is copyright &copy; 2005 by Timothy P. Hunter.</li>
401
442
 
402
- <li>ImageMagick is copyright &copy; 2004 ImageMagick
443
+ <li>ImageMagick is copyright &copy; 2005 ImageMagick
403
444
  Studio.</li>
404
445
 
405
- <li>GraphicsMagick is copyright &copy; 2004 GraphicsMagick
446
+ <li>GraphicsMagick is copyright &copy; 2005 GraphicsMagick
406
447
  Group.</li>
407
448
 
408
449
  <li>Ruby is copyrighted free software by Yukihiro
@@ -4,7 +4,7 @@
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 September 2004), see www.w3.org" />
7
+ "HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
8
8
 
9
9
  <title>RMagick: class Image::Info - Optional method
10
10
  arguments</title>
@@ -12,7 +12,7 @@
12
12
  "text/html; charset=us-ascii" />
13
13
  <meta name="GENERATOR" content="Quanta Plus" />
14
14
  <meta name="Copyright" content=
15
- "Copyright (C) 2004 by Timothy P. Hunter" />
15
+ "Copyright (C) 2005 by Timothy P. Hunter" />
16
16
  <link rel="stylesheet" type="text/css" href="css/doc.css" />
17
17
  <script type="text/javascript" src="scripts/doc.js">
18
18
  </script>
@@ -60,7 +60,13 @@
60
60
  <h3>instance methods</h3>
61
61
 
62
62
  <ul>
63
+ <li><a href="#aset">[]=</a></li>
64
+
65
+ <li><a href="#aref">[]</a></li>
66
+
63
67
  <li><a href="#define">define</a></li>
68
+
69
+ <li><a href="#undefine">undefine</a></li>
64
70
  </ul>
65
71
 
66
72
  <h3>attribute methods</h3>
@@ -169,6 +175,101 @@
169
175
 
170
176
  <h2 class="methods">instance methods</h2>
171
177
 
178
+ <div class="sig">
179
+ <h3 id="aset">[]=</h3>
180
+
181
+ <p><span class="arg">self</span>[<span class=
182
+ "arg">format</span>, <span class="arg">key</span>] =
183
+ <span class="arg">value</span> -&gt; <span class=
184
+ "arg">self</span></p>
185
+ </div>
186
+
187
+ <div class="desc">
188
+ <h4>Description</h4>
189
+
190
+ <p>Define a format-specific option. An alternative to <a href=
191
+ "#define">define</a>, below. Use this method to set options for
192
+ reading or writing certain image formats. ImageMagick and
193
+ GraphicsMagick support different options, and the list of
194
+ supported options changes from release to release. For a list
195
+ of the valid image formats, keys, and values, refer to the
196
+ documentation for the -define option for the specific release
197
+ of the library you're using.</p>
198
+
199
+ <h4>Arguments</h4>
200
+
201
+ <dl>
202
+ <dt>format</dt>
203
+
204
+ <dd>An image format name such as "ps" or "tiff".</dd>
205
+
206
+ <dt>key</dt>
207
+
208
+ <dd>A string that identifies the option.</dd>
209
+
210
+ <dt>value</dt>
211
+
212
+ <dd>The value of the option. <span class="arg">Value</span>
213
+ can be any object that responds to <code>to_s</code>. Use
214
+ <code>nil</code> to set the key to a null value.</dd>
215
+ </dl>
216
+
217
+ <h4>Returns</h4>
218
+
219
+ <p>self</p>
220
+
221
+ <h4>Example</h4>
222
+ <pre>
223
+ self["tiff", "bits-per-sample"] = 2
224
+ </pre>
225
+
226
+ <h4>Magick API</h4>
227
+
228
+ <p>SetImageOption (ImageMagick 6.0.0), AddDefinitions
229
+ (GraphicsMagick 1.1)</p>
230
+ </div>
231
+
232
+ <div class="sig">
233
+ <h3 id="aref">[]</h3>
234
+
235
+ <p><span class="arg">self</span>[<span class=
236
+ "arg">format</span>, <span class="arg">key</span>] -&gt;
237
+ <span class="arg">value</span></p>
238
+ </div>
239
+
240
+ <div class="desc">
241
+ <h4>Description</h4>
242
+
243
+ <p>Returns the value of the specified option for the specified
244
+ format.</p>
245
+
246
+ <h4>Arguments</h4>
247
+
248
+ <dl>
249
+ <dt>format</dt>
250
+
251
+ <dd>An image format name such as "ps" or "tiff".</dd>
252
+
253
+ <dt>key</dt>
254
+
255
+ <dd>A string that identifies the option.</dd>
256
+ </dl>
257
+
258
+ <h4>Returns</h4>
259
+
260
+ <p>The value of the option. Always a string.</p>
261
+
262
+ <h4>Example</h4>
263
+ <pre>
264
+ self["tiff", "bits-per-sample"] &raquo; 2
265
+ </pre>
266
+
267
+ <h4>Magick API</h4>
268
+
269
+ <p>GetImageOption (ImageMagick 6.0.0), AccessDefinitions
270
+ (GraphicsMagick 1.1)</p>
271
+ </div>
272
+
172
273
  <div class="sig">
173
274
  <h3 id="define">define</h3>
174
275
 
@@ -178,11 +279,10 @@
178
279
  </div>
179
280
 
180
281
  <div class="desc">
181
- <h4>Description</h4>Define a format-specific option. The
182
- <code>define</code> method is a new, general-purpose way of
183
- specifying options that apply to specific image formats. This
184
- method is available in ImageMagick 6.0.0 and GraphicsMagick
185
- 1.1.
282
+ <h4>Description</h4>
283
+
284
+ <p>Define a format-specific option. See <a href="aset">[]=</a>,
285
+ above.</p>
186
286
 
187
287
  <h4>Arguments</h4>
188
288
 
@@ -197,8 +297,9 @@
197
297
 
198
298
  <dt>value</dt>
199
299
 
200
- <dd>The value of the option. If omitted, the key is simply
201
- defined to an null value.</dd>
300
+ <dd>The value of the option. <span class="arg">Value</span>
301
+ can be any object that responds to <code>to_s</code>. If
302
+ omitted, the key is simply defined to an null value.</dd>
202
303
  </dl>
203
304
 
204
305
  <h4>Returns</h4>
@@ -206,10 +307,6 @@
206
307
  <p>self</p>
207
308
 
208
309
  <h4>Example</h4>
209
-
210
- <p>See the &times;Magick documentation for the -define utility
211
- command option for a list of valid formats, keys, and
212
- values.</p>
213
310
  <pre>
214
311
  self.define("tiff", "bits-per-sample", 2)
215
312
  </pre>
@@ -220,6 +317,45 @@ self.define("tiff", "bits-per-sample", 2)
220
317
  (GraphicsMagick 1.1)</p>
221
318
  </div>
222
319
 
320
+ <div class="sig">
321
+ <h3 id="undefine">undefine</h3>
322
+
323
+ <p><span class="arg">self</span>.undefine(<span class=
324
+ "arg">format</span>, <span class="arg">key</span>)</p>
325
+ </div>
326
+
327
+ <div class="desc">
328
+ <h4>Description</h4>
329
+
330
+ <p>Delete an option definition set by <a href="#aset">[]=</a>
331
+ or <a href="#define">define</a>. This is not the same as
332
+ setting the option to a null value. The <code>undefine</code>
333
+ method removes the option name from the list of options for the
334
+ specified format.</p>
335
+
336
+ <h4>Arguments</h4>
337
+
338
+ <dl>
339
+ <dt>format</dt>
340
+
341
+ <dd>An image format name such as "ps" or "tiff".</dd>
342
+
343
+ <dt>key</dt>
344
+
345
+ <dd>A string that identifies the option.</dd>
346
+ </dl>
347
+
348
+ <h4>Returns</h4>
349
+
350
+ <p>self</p>
351
+
352
+ <h4>Example</h4>
353
+ <pre>
354
+ self.undefine("tiff", "bits-per-sample")
355
+
356
+ </pre>
357
+ </div>
358
+
223
359
  <h2 class="methods">attribute methods</h2>
224
360
 
225
361
  <div class="sig">