rmagick 1.7.1

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 (239) hide show
  1. data/ChangeLog +232 -0
  2. data/Makefile.in +28 -0
  3. data/README.html +404 -0
  4. data/README.txt +397 -0
  5. data/configure +8554 -0
  6. data/configure.ac +497 -0
  7. data/doc/comtasks.html +241 -0
  8. data/doc/constants.html +1195 -0
  9. data/doc/css/doc.css +299 -0
  10. data/doc/css/popup.css +34 -0
  11. data/doc/draw.html +3108 -0
  12. data/doc/ex/Adispatch.rb +43 -0
  13. data/doc/ex/Zconstitute.rb +9 -0
  14. data/doc/ex/adaptive_threshold.rb +19 -0
  15. data/doc/ex/add_noise.rb +18 -0
  16. data/doc/ex/affine.rb +48 -0
  17. data/doc/ex/affine_transform.rb +20 -0
  18. data/doc/ex/arc.rb +47 -0
  19. data/doc/ex/arcpath.rb +33 -0
  20. data/doc/ex/average.rb +15 -0
  21. data/doc/ex/axes.rb +64 -0
  22. data/doc/ex/bilevel_channel.rb +20 -0
  23. data/doc/ex/blur_image.rb +12 -0
  24. data/doc/ex/border.rb +10 -0
  25. data/doc/ex/bounding_box.rb +48 -0
  26. data/doc/ex/cbezier1.rb +40 -0
  27. data/doc/ex/cbezier2.rb +40 -0
  28. data/doc/ex/cbezier3.rb +40 -0
  29. data/doc/ex/cbezier4.rb +41 -0
  30. data/doc/ex/cbezier5.rb +41 -0
  31. data/doc/ex/cbezier6.rb +51 -0
  32. data/doc/ex/channel.rb +26 -0
  33. data/doc/ex/channel_threshold.rb +48 -0
  34. data/doc/ex/charcoal.rb +12 -0
  35. data/doc/ex/chop.rb +29 -0
  36. data/doc/ex/circle.rb +31 -0
  37. data/doc/ex/clip_path.rb +56 -0
  38. data/doc/ex/coalesce.rb +60 -0
  39. data/doc/ex/color_fill_to_border.rb +29 -0
  40. data/doc/ex/color_floodfill.rb +28 -0
  41. data/doc/ex/color_histogram.rb +60 -0
  42. data/doc/ex/color_reset.rb +11 -0
  43. data/doc/ex/colorize.rb +16 -0
  44. data/doc/ex/colors.rb +65 -0
  45. data/doc/ex/composite.rb +135 -0
  46. data/doc/ex/contrast.rb +37 -0
  47. data/doc/ex/crop.rb +31 -0
  48. data/doc/ex/crop_with_gravity.rb +46 -0
  49. data/doc/ex/cycle_colormap.rb +21 -0
  50. data/doc/ex/demo.rb +324 -0
  51. data/doc/ex/drawcomp.rb +42 -0
  52. data/doc/ex/drop_shadow.rb +60 -0
  53. data/doc/ex/edge.rb +11 -0
  54. data/doc/ex/ellipse.rb +43 -0
  55. data/doc/ex/emboss.rb +11 -0
  56. data/doc/ex/enhance.rb +28 -0
  57. data/doc/ex/equalize.rb +11 -0
  58. data/doc/ex/flatten_images.rb +38 -0
  59. data/doc/ex/flip.rb +11 -0
  60. data/doc/ex/flop.rb +11 -0
  61. data/doc/ex/fonts.rb +20 -0
  62. data/doc/ex/frame.rb +12 -0
  63. data/doc/ex/gaussian_blur.rb +11 -0
  64. data/doc/ex/get_multiline_type_metrics.rb +53 -0
  65. data/doc/ex/get_pixels.rb +48 -0
  66. data/doc/ex/get_type_metrics.rb +140 -0
  67. data/doc/ex/gradientfill.rb +27 -0
  68. data/doc/ex/grav.rb +44 -0
  69. data/doc/ex/gravity.rb +80 -0
  70. data/doc/ex/hatchfill.rb +27 -0
  71. data/doc/ex/images/Ballerina.jpg +0 -0
  72. data/doc/ex/images/Ballerina3.jpg +0 -0
  73. data/doc/ex/images/Button_0.gif +0 -0
  74. data/doc/ex/images/Button_1.gif +0 -0
  75. data/doc/ex/images/Button_2.gif +0 -0
  76. data/doc/ex/images/Button_3.gif +0 -0
  77. data/doc/ex/images/Button_4.gif +0 -0
  78. data/doc/ex/images/Button_5.gif +0 -0
  79. data/doc/ex/images/Button_6.gif +0 -0
  80. data/doc/ex/images/Button_7.gif +0 -0
  81. data/doc/ex/images/Button_8.gif +0 -0
  82. data/doc/ex/images/Button_9.gif +0 -0
  83. data/doc/ex/images/Button_A.gif +0 -0
  84. data/doc/ex/images/Button_B.gif +0 -0
  85. data/doc/ex/images/Button_C.gif +0 -0
  86. data/doc/ex/images/Button_D.gif +0 -0
  87. data/doc/ex/images/Button_E.gif +0 -0
  88. data/doc/ex/images/Button_F.gif +0 -0
  89. data/doc/ex/images/Button_G.gif +0 -0
  90. data/doc/ex/images/Button_H.gif +0 -0
  91. data/doc/ex/images/Button_I.gif +0 -0
  92. data/doc/ex/images/Button_J.gif +0 -0
  93. data/doc/ex/images/Button_K.gif +0 -0
  94. data/doc/ex/images/Button_L.gif +0 -0
  95. data/doc/ex/images/Button_M.gif +0 -0
  96. data/doc/ex/images/Button_N.gif +0 -0
  97. data/doc/ex/images/Button_O.gif +0 -0
  98. data/doc/ex/images/Button_P.gif +0 -0
  99. data/doc/ex/images/Button_Q.gif +0 -0
  100. data/doc/ex/images/Button_R.gif +0 -0
  101. data/doc/ex/images/Button_S.gif +0 -0
  102. data/doc/ex/images/Button_T.gif +0 -0
  103. data/doc/ex/images/Button_U.gif +0 -0
  104. data/doc/ex/images/Button_V.gif +0 -0
  105. data/doc/ex/images/Button_W.gif +0 -0
  106. data/doc/ex/images/Button_X.gif +0 -0
  107. data/doc/ex/images/Button_Y.gif +0 -0
  108. data/doc/ex/images/Button_Z.gif +0 -0
  109. data/doc/ex/images/Cheetah.jpg +0 -0
  110. data/doc/ex/images/Coffee.wmf +0 -0
  111. data/doc/ex/images/Flower_Hat.jpg +0 -0
  112. data/doc/ex/images/Gold_Statue.jpg +0 -0
  113. data/doc/ex/images/Hot_Air_Balloons.jpg +0 -0
  114. data/doc/ex/images/Hot_Air_Balloons_H.jpg +0 -0
  115. data/doc/ex/images/No.wmf +0 -0
  116. data/doc/ex/images/Polynesia.jpg +0 -0
  117. data/doc/ex/images/Red_Rocks.jpg +0 -0
  118. data/doc/ex/images/Shorts.jpg +0 -0
  119. data/doc/ex/images/Snake.wmf +0 -0
  120. data/doc/ex/images/Violin.jpg +0 -0
  121. data/doc/ex/images/graydient230x6.gif +0 -0
  122. data/doc/ex/images/logo400x83.gif +0 -0
  123. data/doc/ex/images/model.miff +0 -0
  124. data/doc/ex/images/notimplemented.gif +0 -0
  125. data/doc/ex/images/smile.miff +0 -0
  126. data/doc/ex/images/spin.gif +0 -0
  127. data/doc/ex/implode.rb +32 -0
  128. data/doc/ex/level.rb +12 -0
  129. data/doc/ex/level_channel.rb +33 -0
  130. data/doc/ex/line.rb +40 -0
  131. data/doc/ex/map.rb +28 -0
  132. data/doc/ex/map_f.rb +15 -0
  133. data/doc/ex/matte_fill_to_border.rb +42 -0
  134. data/doc/ex/matte_floodfill.rb +35 -0
  135. data/doc/ex/matte_replace.rb +42 -0
  136. data/doc/ex/median_filter.rb +28 -0
  137. data/doc/ex/modulate.rb +11 -0
  138. data/doc/ex/mono.rb +23 -0
  139. data/doc/ex/morph.rb +26 -0
  140. data/doc/ex/mosaic.rb +35 -0
  141. data/doc/ex/motion_blur.rb +11 -0
  142. data/doc/ex/negate.rb +11 -0
  143. data/doc/ex/negate_channel.rb +19 -0
  144. data/doc/ex/normalize.rb +11 -0
  145. data/doc/ex/oil_paint.rb +11 -0
  146. data/doc/ex/opacity.rb +38 -0
  147. data/doc/ex/opaque.rb +14 -0
  148. data/doc/ex/ordered_dither.rb +11 -0
  149. data/doc/ex/path.rb +62 -0
  150. data/doc/ex/pattern1.rb +25 -0
  151. data/doc/ex/pattern2.rb +26 -0
  152. data/doc/ex/polygon.rb +24 -0
  153. data/doc/ex/polyline.rb +23 -0
  154. data/doc/ex/posterize.rb +19 -0
  155. data/doc/ex/preview.rb +16 -0
  156. data/doc/ex/qbezierpath.rb +49 -0
  157. data/doc/ex/quantize-m.rb +25 -0
  158. data/doc/ex/radial_blur.rb +19 -0
  159. data/doc/ex/raise.rb +11 -0
  160. data/doc/ex/random_channel_threshold.rb +17 -0
  161. data/doc/ex/random_threshold_channel.rb +18 -0
  162. data/doc/ex/rectangle.rb +33 -0
  163. data/doc/ex/reduce_noise.rb +28 -0
  164. data/doc/ex/roll.rb +9 -0
  165. data/doc/ex/rotate.rb +43 -0
  166. data/doc/ex/rotate_f.rb +14 -0
  167. data/doc/ex/roundrect.rb +32 -0
  168. data/doc/ex/rubyname.rb +31 -0
  169. data/doc/ex/segment.rb +11 -0
  170. data/doc/ex/shade.rb +11 -0
  171. data/doc/ex/shave.rb +15 -0
  172. data/doc/ex/shear.rb +10 -0
  173. data/doc/ex/skewx.rb +50 -0
  174. data/doc/ex/skewy.rb +45 -0
  175. data/doc/ex/smile.rb +124 -0
  176. data/doc/ex/solarize.rb +11 -0
  177. data/doc/ex/splice.rb +16 -0
  178. data/doc/ex/spread.rb +11 -0
  179. data/doc/ex/stegano.rb +50 -0
  180. data/doc/ex/stroke_dasharray.rb +41 -0
  181. data/doc/ex/stroke_linecap.rb +44 -0
  182. data/doc/ex/stroke_linejoin.rb +48 -0
  183. data/doc/ex/stroke_width.rb +47 -0
  184. data/doc/ex/swirl.rb +17 -0
  185. data/doc/ex/text.rb +32 -0
  186. data/doc/ex/text_align.rb +36 -0
  187. data/doc/ex/text_antialias.rb +33 -0
  188. data/doc/ex/text_undercolor.rb +26 -0
  189. data/doc/ex/texture_fill_to_border.rb +34 -0
  190. data/doc/ex/texture_floodfill.rb +31 -0
  191. data/doc/ex/texturefill.rb +25 -0
  192. data/doc/ex/threshold.rb +13 -0
  193. data/doc/ex/to_blob.rb +14 -0
  194. data/doc/ex/translate.rb +37 -0
  195. data/doc/ex/transparent.rb +38 -0
  196. data/doc/ex/trim.rb +25 -0
  197. data/doc/ex/unsharp_mask.rb +28 -0
  198. data/doc/ex/viewex.rb +36 -0
  199. data/doc/ex/wave.rb +9 -0
  200. data/doc/ilist.html +1592 -0
  201. data/doc/image1.html +3009 -0
  202. data/doc/image2.html +2169 -0
  203. data/doc/image3.html +2815 -0
  204. data/doc/imageattrs.html +1319 -0
  205. data/doc/imusage.html +403 -0
  206. data/doc/index.html +418 -0
  207. data/doc/info.html +949 -0
  208. data/doc/magick.html +439 -0
  209. data/doc/scripts/doc.js +9 -0
  210. data/doc/struct.html +1334 -0
  211. data/doc/usage.html +1318 -0
  212. data/examples/describe.rb +44 -0
  213. data/examples/histogram.rb +289 -0
  214. data/examples/image_opacity.rb +29 -0
  215. data/examples/import_export.rb +31 -0
  216. data/examples/pattern_fill.rb +38 -0
  217. data/examples/rotating_text.rb +47 -0
  218. data/examples/thumbnail.rb +65 -0
  219. data/examples/vignette.rb +79 -0
  220. data/ext/RMagick/MANIFEST +239 -0
  221. data/ext/RMagick/extconf.rb.in +21 -0
  222. data/ext/RMagick/rmagick.h +938 -0
  223. data/ext/RMagick/rmagick_config.h.in +170 -0
  224. data/ext/RMagick/rmdraw.c +1308 -0
  225. data/ext/RMagick/rmfill.c +609 -0
  226. data/ext/RMagick/rmilist.c +685 -0
  227. data/ext/RMagick/rmimage.c +7980 -0
  228. data/ext/RMagick/rminfo.c +982 -0
  229. data/ext/RMagick/rmmain.c +1497 -0
  230. data/ext/RMagick/rmutil.c +2685 -0
  231. data/install.rb +1015 -0
  232. data/lib/RMagick.rb +1486 -0
  233. data/metaconfig.in +6 -0
  234. data/post-clean.rb +12 -0
  235. data/post-install.rb +36 -0
  236. data/post-setup.rb +245 -0
  237. data/rmagick.gemspec +22 -0
  238. data/uninstall.rb +71 -0
  239. metadata +286 -0
data/doc/info.html ADDED
@@ -0,0 +1,949 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
+
4
+ <html xmlns="http://www.w3.org/1999/xhtml">
5
+ <head>
6
+ <meta name="generator" content=
7
+ "HTML Tidy for Linux/x86 (vers 1st September 2004), see www.w3.org" />
8
+
9
+ <title>RMagick: class Image::Info - Optional method
10
+ arguments</title>
11
+ <meta http-equiv="Content-Type" content=
12
+ "text/html; charset=us-ascii" />
13
+ <meta name="GENERATOR" content="Quanta Plus" />
14
+ <meta name="Copyright" content=
15
+ "Copyright (C) 2004 by Timothy P. Hunter" />
16
+ <link rel="stylesheet" type="text/css" href="css/doc.css" />
17
+ <script type="text/javascript" src="scripts/doc.js">
18
+ </script>
19
+ <style type="text/css">
20
+ /*<![CDATA[*/
21
+
22
+ /* Styles local to this page. */
23
+
24
+ h2 {
25
+ margin-top: 1em;
26
+ margin-bottom: 1em;
27
+ padding-left: .3em;
28
+ padding-right: .3em;
29
+ padding-bottom: .5em;
30
+ padding-top: .5em;
31
+ background-color: #545454;
32
+ color: white;
33
+ }
34
+
35
+ #intro h2 {
36
+ clear: both;
37
+ }
38
+ #compression_notes li {
39
+ font-style: italic;
40
+ }
41
+
42
+ /*]]>*/
43
+ </style>
44
+ </head>
45
+
46
+ <body>
47
+ <h6 id="header">RMagick User's Guide and Reference</h6>
48
+
49
+ <div class="nav">
50
+ &laquo;&nbsp;<a href="struct.html">Prev</a> | <a href=
51
+ "index.html">Contents</a> | <a href=
52
+ "constants.html">Next</a>&nbsp;&raquo;
53
+ </div>
54
+
55
+ <h1>class Image::Info - Optional method arguments</h1>
56
+
57
+ <div id="toc">
58
+ <h2>Table of Contents</h2>
59
+
60
+ <h3>instance methods</h3>
61
+
62
+ <ul>
63
+ <li><a href="#define">define</a></li>
64
+ </ul>
65
+
66
+ <h3>attribute methods</h3>
67
+
68
+ <div class="toccol">
69
+ <ul>
70
+ <li><a href="#antialias">antialias</a></li>
71
+
72
+ <li><a href="#background_color">background_color</a></li>
73
+
74
+ <li><a href="#border_color">border_color</a></li>
75
+
76
+ <li><a href="#colorspace">colorspace</a></li>
77
+
78
+ <li><a href="#compression">compression</a></li>
79
+
80
+ <li><a href="#density">density</a></li>
81
+
82
+ <li><a href="#depth">depth</a></li>
83
+
84
+ <li><a href="#dither">dither</a></li>
85
+
86
+ <li><a href="#extract">extract</a></li>
87
+ </ul>
88
+ </div>
89
+
90
+ <div class="toccol">
91
+ <ul>
92
+ <li><a href="#filename">filename</a></li>
93
+
94
+ <li><a href="#font">font</a></li>
95
+
96
+ <li><a href="#format">format</a></li>
97
+
98
+ <li><a href="#fuzz">fuzz</a></li>
99
+
100
+ <li><a href="#image_type">image_type</a></li>
101
+
102
+ <li><a href="#interlace">interlace</a></li>
103
+
104
+ <li><a href="#matte_color">matte_color</a></li>
105
+
106
+ <li><a href="#monochrome">monochrome</a></li>
107
+
108
+ <li><a href="#number_scenes">number_scenes</a></li>
109
+ </ul>
110
+ </div>
111
+
112
+ <div class="toccol">
113
+ <ul>
114
+ <li><a href="#page">page</a></li>
115
+
116
+ <li><a href="#quality">quality</a></li>
117
+
118
+ <li><a href="#scene">scene</a></li>
119
+
120
+ <li><a href="#server_name">server_name</a></li>
121
+
122
+ <li><a href="#size">size</a></li>
123
+
124
+ <li><a href="#subimage">subimage</a></li>
125
+
126
+ <li><a href="#subrange">subrange</a></li>
127
+
128
+ <li><a href="#tile">tile</a></li>
129
+
130
+ <li><a href="#units">units</a></li>
131
+
132
+ <li><a href="#view">view</a></li>
133
+ </ul>
134
+ </div>
135
+ </div>
136
+
137
+ <div id="intro">
138
+ <h2>The Image::Info class</h2>
139
+
140
+ <p>Some <code>Image</code> and <code>ImageList</code> methods,
141
+ such as <code>read</code> and <code>write</code>, accept an
142
+ "optional arguments" block in which you can set attributes that
143
+ modify the method's output. These attributes belong to the
144
+ <code>Image::Info</code> class. The <code>Image::Info</code>
145
+ class exists only to accept optional arguments for those
146
+ <code>Image</code> and <code>ImageList</code> methods.</p>
147
+
148
+ <p>This page explains the methods defined in the
149
+ <code>Image::Info</code> class. Generally, each
150
+ <code>Image</code> or <code>ImageList</code> method that uses
151
+ the <code>Image::Info</code> class to get optional arguments
152
+ will only accept some of the attributes listed on this page,
153
+ that is, only those attributes that are meaningful for the
154
+ particular method. Any other attributes that you set are
155
+ ignored. Also, some attributes are only used by a subset of the
156
+ image formats. See the &times;Magick documentation for more
157
+ information.</p>
158
+
159
+ <p>Remember, you do not ever need to create an
160
+ <code>Image::Info</code> object. The object is created for you
161
+ before the optional arguments block is entered and destroyed
162
+ after the block is exited.</p>
163
+
164
+ <p>All the attributes in the <code>Image::Info</code> class are
165
+ read/write. For simplicity, and because usually you only set
166
+ these attributes, this page only describes the setter version
167
+ of each attribute method.</p>
168
+ </div>
169
+
170
+ <h2 class="methods">instance methods</h2>
171
+
172
+ <div class="sig">
173
+ <h3 id="define">define</h3>
174
+
175
+ <p><span class="arg">self</span>.define(<span class=
176
+ "arg">format</span>, <span class="arg">key</span>[,
177
+ <span class="arg">value</span>])</p>
178
+ </div>
179
+
180
+ <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.
186
+
187
+ <h4>Arguments</h4>
188
+
189
+ <dl>
190
+ <dt>format</dt>
191
+
192
+ <dd>An image format name such as "ps" or "tiff".</dd>
193
+
194
+ <dt>key</dt>
195
+
196
+ <dd>A string that identifies the option.</dd>
197
+
198
+ <dt>value</dt>
199
+
200
+ <dd>The value of the option. If omitted, the key is simply
201
+ defined to an null value.</dd>
202
+ </dl>
203
+
204
+ <h4>Returns</h4>
205
+
206
+ <p>self</p>
207
+
208
+ <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
+ <pre>
214
+ self.define("tiff", "bits-per-sample", 2)
215
+ </pre>
216
+
217
+ <h4>Magick API</h4>
218
+
219
+ <p>SetImageOption (ImageMagick 6.0.0), AddDefinitions
220
+ (GraphicsMagick 1.1)</p>
221
+ </div>
222
+
223
+ <h2 class="methods">attribute methods</h2>
224
+
225
+ <div class="sig">
226
+ <h3 id="antialias">antialias</h3>
227
+
228
+ <p><span class="arg">self.</span>antialias= <span class=
229
+ "arg"><code>true</code></span> or <span class=
230
+ "arg"><code>false</code></span></p>
231
+ </div>
232
+
233
+ <div class="desc">
234
+ <h4>Description</h4>
235
+
236
+ <p><span class="imquote">Control antialiasing of rendered
237
+ Postscript and Postscript or TrueType fonts.</span> The default
238
+ is <code>true</code>.</p>
239
+ </div>
240
+
241
+ <div class="sig">
242
+ <h3 id="background_color">background_color</h3>
243
+
244
+ <p><span class="arg">self.</span>background_color= <span class=
245
+ "arg">aPixel</span> or <em>aPixel</em></p>
246
+ </div>
247
+
248
+ <div class="desc">
249
+ <h4>Description</h4>
250
+
251
+ <p>Set the image background color. The default is "white".</p>
252
+
253
+ <h4>Arguments</h4>
254
+
255
+ <p>A <a href="imusage.html#color_names">color name</a> or a
256
+ <a href="struct.html#Pixel">aPixel</a>.</p>
257
+ </div>
258
+
259
+ <div class="sig">
260
+ <h3 id="border_color">border_color</h3>
261
+
262
+ <p><span class="arg">self.</span>border_color= <span class=
263
+ "arg">aString</span> or <span class="arg">aPixel</span></p>
264
+ </div>
265
+
266
+ <div class="desc">
267
+ <h4>Description</h4>
268
+
269
+ <p>Set the image border color. The default is "#dfdfdf".</p>
270
+
271
+ <h4>Arguments</h4>
272
+
273
+ <p>A <a href="imusage.html#color_names">color name</a> or a
274
+ <a href="struct.html#Pixel">aPixel</a>.</p>
275
+ </div>
276
+
277
+ <div class="sig">
278
+ <h3 id="colorspace">colorspace</h3>
279
+
280
+ <p><span class="arg">self.</span>colorspace= <span class=
281
+ "arg">aColorspaceType</span></p>
282
+ </div>
283
+
284
+ <div class="desc">
285
+ <h4>Description</h4>
286
+
287
+ <p>Specify the image pixel interpretation.</p>
288
+
289
+ <h4>Arguments</h4>A <a href=
290
+ "constants.html#ColorspaceType">ColorspaceType</a> constant.
291
+ </div>
292
+
293
+ <div class="sig">
294
+ <h3 id="compression">compression</h3>
295
+
296
+ <p><span class="arg">self.</span>compression= <span class=
297
+ "arg">aCompressionType</span></p>
298
+ </div>
299
+
300
+ <div class="desc">
301
+ <h4>Description</h4>
302
+
303
+ <p>Specify the type of compression used when writing the image.
304
+ Only some image formats support compression. For those that do,
305
+ only some compression types are supported. If you specify an
306
+ compression type that is not supported, the default compression
307
+ type (usually NoCompression) is used instead.</p>
308
+
309
+ <p>Some compression types support varying levels of
310
+ compression. See the <a href=
311
+ "#quality"><code>quality</code></a> attribute.</p>
312
+
313
+ <p>The following table shows the image formats that support
314
+ compression. For each format, the right-hand column shows the
315
+ supported compression types. The default compression type is
316
+ shown in <strong>bold</strong>.</p>
317
+
318
+ <table class="simple_table" summary=
319
+ "supported compression types by image format">
320
+ <caption>
321
+ Supported Compression Types
322
+ </caption>
323
+
324
+ <tr>
325
+ <th>Format</th>
326
+
327
+ <th>Compression Types</th>
328
+ </tr>
329
+
330
+ <tr>
331
+ <td>BMP</td>
332
+
333
+ <td><strong>NoCompression</strong>, RLECompression</td>
334
+ </tr>
335
+
336
+ <tr>
337
+ <td>DIB</td>
338
+
339
+ <td><strong>NoCompression</strong>, RLECompression</td>
340
+ </tr>
341
+
342
+ <tr>
343
+ <td>FPX</td>
344
+
345
+ <td><strong>NoCompression</strong>, JPEGCompression</td>
346
+ </tr>
347
+
348
+ <tr>
349
+ <td>GIF</td>
350
+
351
+ <td><strong>LZWCompression</strong> <em>(see Notes,
352
+ below)</em></td>
353
+ </tr>
354
+
355
+ <tr>
356
+ <td>JNG</td>
357
+
358
+ <td><strong>NoCompression</strong>, JPEGCompression</td>
359
+ </tr>
360
+
361
+ <tr>
362
+ <td>JP2</td>
363
+
364
+ <td><strong>JPEGCompression</strong>,
365
+ LosslessJPEGCompression</td>
366
+ </tr>
367
+
368
+ <tr>
369
+ <td>JPG</td>
370
+
371
+ <td><strong>JPEGCompression</strong>,
372
+ LosslessJPEGCompression</td>
373
+ </tr>
374
+
375
+ <tr>
376
+ <td>MIFF</td>
377
+
378
+ <td><strong>NoCompression</strong>, RLECompression</td>
379
+ </tr>
380
+
381
+ <tr>
382
+ <td>MNG</td>
383
+
384
+ <td><strong>NoCompression</strong>, JPEGCompression</td>
385
+ </tr>
386
+
387
+ <tr>
388
+ <td>PALM</td>
389
+
390
+ <td><strong>NoCompression</strong>, FaxCompression,
391
+ RLECompression</td>
392
+ </tr>
393
+
394
+ <tr>
395
+ <td>PDB</td>
396
+
397
+ <td><strong>NoCompression</strong>, RLECompression</td>
398
+ </tr>
399
+
400
+ <tr>
401
+ <td>PDF</td>
402
+
403
+ <td><strong>NoCompression</strong>, JPEGCompression,
404
+ LZWCompression, ZipCompression</td>
405
+ </tr>
406
+
407
+ <tr>
408
+ <td>PICT</td>
409
+
410
+ <td><strong>NoCompression</strong>, JPEGCompression</td>
411
+ </tr>
412
+
413
+ <tr>
414
+ <td>PNG</td>
415
+
416
+ <td><strong>NoCompression</strong>, ZIPCompression</td>
417
+ </tr>
418
+
419
+ <tr>
420
+ <td>PS</td>
421
+
422
+ <td><strong>NoCompression</strong>, RLECompression</td>
423
+ </tr>
424
+
425
+ <tr>
426
+ <td>PS2</td>
427
+
428
+ <td><strong>RLECompression</strong>, FaxCompression,
429
+ JPEGCompression, LZWCompression, NoCompression</td>
430
+ </tr>
431
+
432
+ <tr>
433
+ <td>PS3</td>
434
+
435
+ <td><strong>FaxCompression</strong>, JPEGCompression,
436
+ LZWCompression, NoCompression, RLECompression,
437
+ ZipCompression</td>
438
+ </tr>
439
+
440
+ <tr>
441
+ <td>TIFF</td>
442
+
443
+ <td><strong>NoCompression</strong>, FaxCompression,
444
+ Group4Compression, JPEGCompression, LZWCompression,
445
+ RLECompression, ZipCompression</td>
446
+ </tr>
447
+ </table>
448
+
449
+ <h5>Notes</h5>
450
+
451
+ <ol id="compression_notes">
452
+ <li>NoCompression is accepted for all image formats. Except
453
+ as noted in the table, it is the default.</li>
454
+
455
+ <li>Prior to July 10, 2004, the default for GIF images was
456
+ NoCompression.</li>
457
+
458
+ <li>&times;Magick must be configured and built with extra
459
+ support to use LZWCompression (in releases prior to July 10,
460
+ 2004) and LosslessJPEGCompression.</li>
461
+
462
+ <li>This table is based on my examination of the
463
+ &times;Magick source code. It is not necessarily complete and
464
+ it may contain mistakes. If you need an authoritative list,
465
+ you should consult the &times;Magick developers.</li>
466
+ </ol>
467
+
468
+ <h4>Arguments</h4>A <a href=
469
+ "constants.html#CompressionType">CompressionType</a> constant.
470
+ </div>
471
+
472
+ <div class="sig">
473
+ <h3 id="density">density</h3>
474
+
475
+ <p><span class="arg">self.</span>density= <span class=
476
+ "arg">aString</span> or <span class="arg">aGeometry</span></p>
477
+ </div>
478
+
479
+ <div class="desc">
480
+ <h4>Description</h4>
481
+
482
+ <p>Specify the vertical and horizontal resolution in pixels.
483
+ The default density is "72.0x72.0". This attribute can be used
484
+ when writing JBIG, PCL, PS, PS2, and PS3 format images.</p>
485
+
486
+ <p>This attribute can also be used to specify the width and
487
+ height of HISTOGRRAM format images. For HISTOGRAM, the default
488
+ is 256x200.</p>
489
+
490
+ <h4>Arguments</h4>
491
+
492
+ <p>The argument can be either a string in the form "XxY" where
493
+ "X" is the horizontal resolution and "Y" is the vertical
494
+ resolution, or a <a href="struct.html#Geometry">Geometry</a>
495
+ object where <code>width</code> is the horizontal resolution
496
+ and <code>height</code> is the vertical resolution.</p>
497
+ </div>
498
+
499
+ <div class="sig">
500
+ <h3 id="depth">depth</h3>
501
+
502
+ <p><span class="arg">self.</span>depth= <span class=
503
+ "arg">aNumber</span></p>
504
+ </div>
505
+
506
+ <div class="desc">
507
+ <h4>Description</h4>
508
+
509
+ <p>Specify the image depth.</p>
510
+
511
+ <h4>Arguments</h4>
512
+
513
+ <p>Either 8, 16, or 32. You can specify 16 and 32 only when
514
+ &times;Magick was compiled with a QuantumDepth that allows
515
+ these depth values.</p>
516
+
517
+ <p>Use <code>depth</code> to specify the depth of CMYK, GRAY,
518
+ RGB, RGBA, MAP, and XC format images. See also <a href=
519
+ "#size"><code>size</code></a>.</p>
520
+ </div>
521
+
522
+ <div class="sig">
523
+ <h3 id="dither">dither</h3>
524
+
525
+ <p><span class="arg">self.</span>dither= <span class=
526
+ "arg"><code>true</code></span> or <span class=
527
+ "arg"><code>false</code></span></p>
528
+ </div>
529
+
530
+ <div class="desc">
531
+ <h4>Description</h4>
532
+
533
+ <p>This attribute can be used when writing GIF images.</p>
534
+
535
+ <p class="imquote">Apply Floyd/Steinberg error diffusion to the
536
+ image. The basic strategy of dithering is to trade intensity
537
+ resolution for spatial resolution by averaging the intensities
538
+ of several neighboring pixels. Images which suffer from severe
539
+ contouring when reducing colors can be improved with this
540
+ option.</p>
541
+ </div>
542
+
543
+ <div class="sig">
544
+ <h3 id="extract">extract</h3>
545
+
546
+ <p><span class="arg"><em>self.</em></span>extract= <span class=
547
+ "arg">aString</span> or <span class="arg">aGeometry</span></p>
548
+ </div>
549
+
550
+ <div class="desc">
551
+ <h4>Description</h4>
552
+
553
+ <p>Specify a portion of an image to be extracted when the image
554
+ is constituted. This attribute can be used to identify a subset
555
+ of an image that is otherwise too large to keep in memory.</p>
556
+
557
+ <h4>Arguments</h4>
558
+
559
+ <p>Either a geometry string or a <a href=
560
+ "struct.html#Geometry">Geometry</a> object. For example:
561
+ <code>self.extract = "200x200+100+100"</code>.</p>
562
+
563
+ <h4>Notes</h4>
564
+
565
+ <p>This attribute replaces the <a href="#Info.tile_eq">tile</a>
566
+ attribute, which is deprecated in ImageMagick 5.5.6 and
567
+ later.</p>
568
+ </div>
569
+
570
+ <div class="sig">
571
+ <h3 id="filename">filename</h3>
572
+
573
+ <p><span class="arg">self.</span>filename= <span class=
574
+ "arg">aString</span></p>
575
+ </div>
576
+
577
+ <div class="desc">
578
+ <h4>Description</h4>
579
+
580
+ <p>See <a href="image1.html#capture">capture</a>.</p>
581
+ </div>
582
+
583
+ <div class="sig">
584
+ <h3 id="font">font</h3>
585
+
586
+ <p><span class="arg">self.</span>font= <span class=
587
+ "arg">aString</span></p>
588
+ </div>
589
+
590
+ <div class="desc">
591
+ <h4>Description</h4>
592
+
593
+ <p>Set the text rendering font.</p>
594
+ </div>
595
+
596
+ <div class="sig">
597
+ <h3 id="format">format</h3>
598
+
599
+ <p><span class="arg">self.</span>format= <span class=
600
+ "arg">aString</span></p>
601
+ </div>
602
+
603
+ <div class="desc">
604
+ <h4>Description</h4>
605
+
606
+ <p>Set the image format, "GIF" or "JPG" for example.</p>
607
+
608
+ <h4>Arguments</h4>
609
+
610
+ <p>See <a href=
611
+ "http://www.imagemagick.org/www/formats.html">File
612
+ Formats</a>.</p>
613
+ </div>
614
+
615
+ <div class="sig">
616
+ <h3 id="fuzz">fuzz</h3>
617
+
618
+ <p><span class="arg">self.</span>fuzz= <span class=
619
+ "arg">aNumeric</span> or <span class="arg">aString</span></p>
620
+ </div>
621
+
622
+ <div class="desc">
623
+ <h4>Description</h4>
624
+
625
+ <p>Set the level of "fuzziness" for comparing pixels. By
626
+ default the pixels must be identical to be considered equal.
627
+ The larger the <code>fuzz</code> value the more difference is
628
+ tolerated. See <a href=
629
+ "imageattrs.html#fuzz">Image#fuzz</a>.</p>
630
+
631
+ <h4>Arguments</h4>
632
+
633
+ <p>The argument may be a numeric value or a string in the form
634
+ "NN%". In the second case, the argument is computed as a
635
+ percentage of <a href=
636
+ "constants.html#Miscellaneous_constants">MaxRGB</a>. For
637
+ example, a value of '5%' sets <code>fuzz</code> to
638
+ 0.05*MaxRGB.</p>
639
+ </div>
640
+
641
+ <div class="sig">
642
+ <h3 id="image_type">image_type</h3>
643
+
644
+ <p><span class="arg">self.</span>image_type= <span class=
645
+ "arg">anImageType</span></p>
646
+ </div>
647
+
648
+ <div class="desc">
649
+ <h4>Description</h4>
650
+
651
+ <p>The image type classification. For example, GrayscaleType.
652
+ Don't confuse this attribute with the <a href=
653
+ "#format">format</a> such as "GIF" or "JPG".</p>
654
+
655
+ <h4>Arguments</h4>
656
+
657
+ <p>An <a href="constants.html#ImageType">ImageType</a>
658
+ constant.</p>
659
+ </div>
660
+
661
+ <div class="sig">
662
+ <h3 id="interlace">interlace</h3>
663
+
664
+ <p><span class="arg">self.</span>interlace= <span class=
665
+ "arg">anInterlaceType</span></p>
666
+ </div>
667
+
668
+ <div class="desc">
669
+ <h4>Description</h4>
670
+
671
+ <p><span class="imquote">[S]pecify the type of interlacing
672
+ scheme for raw image formats such as RGB or YUV. NoInterlace
673
+ means do not interlace, LineInterlace uses scanline
674
+ interlacing, and PlaneInterlace uses plane interlacing.
675
+ PartitionInterlace is like PlaneInterlace except the different
676
+ planes are saved to individual files (e.g. image.R, image.G,
677
+ and image.B). Use LineInterlace or PlaneInterlace to create an
678
+ interlaced GIF or progressive JPEG image.</span> The default is
679
+ NoInterlace.</p>
680
+
681
+ <h4>Arguments</h4>An <a href=
682
+ "constants.html#InterlaceType">InterlaceType</a> constant.
683
+ </div>
684
+
685
+ <div class="sig">
686
+ <h3 id="matte_color">matte_color</h3>
687
+
688
+ <p><span class="arg">self.</span>matte_color= <span class=
689
+ "arg">aString</span> or <span class="arg">aPixel</span></p>
690
+ </div>
691
+
692
+ <div class="desc">
693
+ <h4>Description</h4>
694
+
695
+ <p>Set the image transparent color. The default is
696
+ "#bdbdbd".</p>
697
+
698
+ <h4>Arguments</h4>
699
+
700
+ <p>A <a href="imusage.html#color_names">color name</a> or a
701
+ <a href="struct.html#Pixel">aPixel</a>.</p>
702
+ </div>
703
+
704
+ <div class="sig">
705
+ <h3 id="monochrome">monochrome</h3>
706
+
707
+ <p><span class="arg">self.</span>monochrome= <span class=
708
+ "arg"><code>true</code></span> or <span class=
709
+ "arg"><code>false</code></span></p>
710
+ </div>
711
+
712
+ <div class="desc">
713
+ <h4>Description</h4>
714
+
715
+ <p>Transform the image to black and white on input. Only the
716
+ EPT, PDF, and PS formats respect this attribute.</p>
717
+ </div>
718
+
719
+ <div class="sig">
720
+ <h3 id="number_scenes">number_scenes</h3>
721
+
722
+ <p><span class="arg">self.</span>number_scenes= <span class=
723
+ "arg">anInteger</span></p>
724
+ </div>
725
+
726
+ <div class="desc">
727
+ <h4>Description</h4>
728
+
729
+ <p>Used in conjunction with <a href="#scene">scene</a> to
730
+ specify the range of frames to be extracted when constituting a
731
+ multi-frame image.</p>
732
+
733
+ <h4>Note</h4>
734
+
735
+ <p>This attribute replaces the <a href="#subrange">subrange</a>
736
+ attribute, which is deprecated in ImageMagick 5.5.6 and later.
737
+ If <code>number_scenes</code> is used with a version of
738
+ ImageMagick prior to 5.5.6, it is a synonym for the
739
+ <code>subrange</code> attribute.</p>
740
+ </div>
741
+
742
+ <div class="sig">
743
+ <h3 id="page">page</h3>
744
+
745
+ <p><span class="arg">self.</span>page= <span class=
746
+ "arg">aString</span> or <span class="arg">aGeometry</span></p>
747
+ </div>
748
+
749
+ <div class="desc">
750
+ <h4>Description</h4>
751
+
752
+ <p>Set the equivalent size of the Postscript page. The default
753
+ is "612x792&gt;".</p>
754
+
755
+ <h4>Arguments</h4>
756
+
757
+ <p>A <a href="imusage.html#geometry">geometry string</a> or a
758
+ <a href="struct.html#Geometry">Geometry</a> object.</p>
759
+ </div>
760
+
761
+ <div class="sig">
762
+ <h3 id="quality">quality</h3>
763
+
764
+ <p><span class="arg">self.</span>quality= <span class=
765
+ "arg">anInteger</span></p>
766
+ </div>
767
+
768
+ <div class="desc">
769
+ <h4>Description</h4>
770
+
771
+ <p>Set the compression level to use with the
772
+ <code>JPEGCompression</code> and <code>ZipCompression</code>
773
+ types. The value may range from 0 to 100, with 100 representing
774
+ the least compression. The default is 75. See <em><a href=
775
+ "comtasks.html#compressing">Compressing image
776
+ files</a></em>.</p>
777
+ </div>
778
+
779
+ <div class="sig">
780
+ <h3 id="scene">scene</h3>
781
+
782
+ <p><em>self.</em>scene= <em>anInteger</em></p>
783
+ </div>
784
+
785
+ <div class="desc">
786
+ <h4>Description</h4>
787
+
788
+ <p>Used in conjunction with <a href=
789
+ "#number_scenes">number_scenes</a> to specify the range of
790
+ frames to be extracted when constituting a multi-frame
791
+ image.</p>
792
+
793
+ <h4>Note</h4>
794
+
795
+ <p>This attribute replaces the <a href="#subimage">subimage</a>
796
+ attribute, which is deprecated in ImageMagick 5.5.6 and later.
797
+ If <code>scene</code> is used with a version of ImageMagick
798
+ prior to 5.5.6, it is a synonym for the <code>subimage</code>
799
+ attribute.</p>
800
+ </div>
801
+
802
+ <div class="sig">
803
+ <h3 id="server_name">server_name</h3>
804
+
805
+ <p><span class="arg">self.</span>server_name= <span class=
806
+ "arg">aString</span></p>
807
+ </div>
808
+
809
+ <div class="desc">
810
+ <h4>Description</h4>
811
+
812
+ <p>Set the X11 display to obtain fonts from.</p>
813
+ </div>
814
+
815
+ <div class="sig">
816
+ <h3 id="size">size</h3>
817
+
818
+ <p><span class="arg"><em>self.</em>size=
819
+ <em>aString</em></span> or <span class=
820
+ "arg">aGeometry</span></p>
821
+ </div>
822
+
823
+ <div class="desc">
824
+ <h4>Description</h4>
825
+
826
+ <p>Set the width and height of the image when reading a
827
+ <a href="imusage.html#builtin_formats">built-in image
828
+ format</a> that does not have an inherent size, or when reading
829
+ an image from a multi-resolution file format such as Photo CD,
830
+ JBIG, or JPEG.</p>
831
+
832
+ <p>Use <code>size</code> to specify the width and height of
833
+ images in the CMYK, DIB, EMF, GRAY, RGB, RGBA, UYVY, YUV, or XC
834
+ formats, the width and height of some <a href=
835
+ "imusage.html#builtin_formats">builtin formats</a>, or the
836
+ subimage size of PTIF-format images.</p>
837
+
838
+ <h4>Arguments</h4>
839
+
840
+ <p>A g<a href="imusage.html#geometry_string">eometry string</a>
841
+ or a <a href="struct.html#Geometry">Geometry</a> object.</p>
842
+ </div>
843
+
844
+ <div class="sig">
845
+ <h3 id="subimage">subimage</h3>
846
+
847
+ <p><span class="arg">self.</span>subimage= <span class=
848
+ "arg">anInteger</span></p>
849
+ </div>
850
+
851
+ <div class="desc">
852
+ <h4>Description</h4>
853
+
854
+ <p>Specify a base image of an image sequence in a multi-frame
855
+ image.</p>
856
+
857
+ <h4>Note</h4>
858
+
859
+ <p>This attribute is deprecated in ImageMagick 5.5.6 and later.
860
+ Use the <a href="#scene">scene</a> attribute instead.</p>
861
+ </div>
862
+
863
+ <div class="sig">
864
+ <h3 id="subrange">subrange</h3>
865
+
866
+ <p><span class="arg">self.</span>subrange= <span class=
867
+ "arg">anInteger</span></p>
868
+ </div>
869
+
870
+ <div class="desc">
871
+ <h4>Description</h4>
872
+
873
+ <p>Specify the number of images relative to the base image. See
874
+ <a href="#subimage">subimage</a>.</p>
875
+
876
+ <h4>Note</h4>
877
+
878
+ <p>This attribute is deprecated in ImageMagick 5.5.6 and later.
879
+ Use the <a href="#number_scenes">number_scenes</a> attribute
880
+ instead.</p>
881
+ </div>
882
+
883
+ <div class="sig">
884
+ <h3 id="tile">tile</h3>
885
+
886
+ <p><span class="arg">self.</span>tile= <span class=
887
+ "arg">aString</span> or <span class="arg">aGeometry</span></p>
888
+ </div>
889
+
890
+ <div class="desc">
891
+ <h4>Description</h4>
892
+
893
+ <p>Specify a portion of an image to be extracted when the image
894
+ is constituted. The argument is a geometry string. For example:
895
+ <code>self.tile = "200x200+100+100"</code>. This attribute can
896
+ be used to identify a subset of an image that is otherwise too
897
+ large to keep in memory.</p>
898
+
899
+ <h4>Arguments</h4>
900
+
901
+ <p>A <a href="imusage.html#geometry_string">geometry string</a>
902
+ or a <a href="struct.html#Geometry">Geometry</a> object.</p>
903
+
904
+ <h4>Note</h4>
905
+
906
+ <p>This attribute is deprecated in ImageMagick 5.5.6 and later.
907
+ Use the <a href="#extract">extract</a> attribute instead.</p>
908
+ </div>
909
+
910
+ <div class="sig">
911
+ <h3 id="units">units</h3>
912
+
913
+ <p><span class="arg">self.</span>units= <span class=
914
+ "arg">aResolutionType</span></p>
915
+ </div>
916
+
917
+ <div class="desc">
918
+ <h4>Description</h4>
919
+
920
+ <p>Specify the units of image resolution.</p>
921
+
922
+ <h4>Arguments</h4>
923
+
924
+ <p>A <a href="constants.html#ResolutionType">ResolutionType</a>
925
+ constant.</p>
926
+ </div>
927
+
928
+ <div class="sig">
929
+ <h3 id="view">view</h3>
930
+
931
+ <p><span class="arg">self.</span>view= <span class=
932
+ "arg">aString</span></p>
933
+ </div>
934
+
935
+ <div class="desc">
936
+ <h4>Description</h4>
937
+
938
+ <p>FlashPix viewing parameters.</p>
939
+ </div>
940
+
941
+ <p class="spacer">&nbsp;</p>
942
+
943
+ <div class="nav">
944
+ &laquo;&nbsp;<a href="struct.html">Prev</a> | <a href=
945
+ "index.html">Contents</a> | <a href=
946
+ "constants.html">Next</a>&nbsp;&raquo;
947
+ </div>
948
+ </body>
949
+ </html>