rmagick 2.13.2 → 4.2.2

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 (380) hide show
  1. checksums.yaml +7 -0
  2. data/.codeclimate.yml +63 -0
  3. data/.editorconfig +17 -0
  4. data/.github/ISSUE_TEMPLATE.md +17 -0
  5. data/.github/workflows/ci.yml +107 -0
  6. data/.gitignore +25 -0
  7. data/.rspec +2 -0
  8. data/.rubocop.yml +37 -0
  9. data/.rubocop_todo.yml +449 -0
  10. data/.yardopts +5 -0
  11. data/CHANGELOG.md +1277 -0
  12. data/CODE_OF_CONDUCT.md +128 -0
  13. data/CONTRIBUTING.md +81 -0
  14. data/Gemfile +4 -0
  15. data/LICENSE +20 -0
  16. data/README.md +324 -0
  17. data/Rakefile +190 -0
  18. data/before_install_linux.sh +69 -0
  19. data/before_install_osx.sh +57 -0
  20. data/deprecated/RMagick.rb +6 -0
  21. data/ext/RMagick/extconf.rb +334 -333
  22. data/ext/RMagick/rmagick.c +129 -127
  23. data/ext/RMagick/rmagick.h +221 -320
  24. data/ext/RMagick/rmdraw.c +458 -767
  25. data/ext/RMagick/rmenum.c +305 -752
  26. data/ext/RMagick/rmfill.c +231 -199
  27. data/ext/RMagick/rmilist.c +437 -478
  28. data/ext/RMagick/rmimage.c +6130 -5342
  29. data/ext/RMagick/rminfo.c +695 -833
  30. data/ext/RMagick/rmkinfo.c +198 -0
  31. data/ext/RMagick/rmmain.c +752 -506
  32. data/ext/RMagick/rmmontage.c +94 -152
  33. data/ext/RMagick/rmpixel.c +619 -425
  34. data/ext/RMagick/rmstruct.c +206 -309
  35. data/ext/RMagick/rmutil.c +514 -344
  36. data/lib/rmagick/version.rb +5 -0
  37. data/lib/rmagick.rb +1 -0
  38. data/lib/rmagick_internal.rb +1922 -0
  39. data/lib/rvg/clippath.rb +35 -39
  40. data/lib/rvg/container.rb +123 -124
  41. data/lib/rvg/deep_equal.rb +45 -49
  42. data/lib/rvg/describable.rb +41 -47
  43. data/lib/rvg/embellishable.rb +380 -411
  44. data/lib/rvg/misc.rb +691 -711
  45. data/lib/rvg/paint.rb +43 -47
  46. data/lib/rvg/pathdata.rb +119 -125
  47. data/lib/rvg/rvg.rb +214 -213
  48. data/lib/rvg/stretchable.rb +153 -162
  49. data/lib/rvg/stylable.rb +111 -117
  50. data/lib/rvg/text.rb +169 -180
  51. data/lib/rvg/transformable.rb +121 -127
  52. data/lib/rvg/units.rb +58 -61
  53. data/rmagick.gemspec +36 -16
  54. metadata +188 -365
  55. data/ChangeLog +0 -773
  56. data/Doxyfile +0 -1514
  57. data/README-Mac-OSX.txt +0 -1
  58. data/README.html +0 -10
  59. data/build_tarball.rake +0 -215
  60. data/doc/comtasks.html +0 -287
  61. data/doc/constants.html +0 -1581
  62. data/doc/css/doc.css +0 -299
  63. data/doc/css/popup.css +0 -34
  64. data/doc/css/ref.css +0 -67
  65. data/doc/draw.html +0 -3269
  66. data/doc/ex/InitialCoords.rb +0 -23
  67. data/doc/ex/NewCoordSys.rb +0 -32
  68. data/doc/ex/OrigCoordSys.rb +0 -18
  69. data/doc/ex/PreserveAspectRatio.rb +0 -205
  70. data/doc/ex/RotateScale.rb +0 -37
  71. data/doc/ex/Skew.rb +0 -38
  72. data/doc/ex/Use01.rb +0 -16
  73. data/doc/ex/Use02.rb +0 -21
  74. data/doc/ex/Use03.rb +0 -16
  75. data/doc/ex/ViewBox.rb +0 -33
  76. data/doc/ex/adaptive_threshold.rb +0 -10
  77. data/doc/ex/add_noise.rb +0 -17
  78. data/doc/ex/affine.rb +0 -48
  79. data/doc/ex/affine_transform.rb +0 -20
  80. data/doc/ex/arc.rb +0 -49
  81. data/doc/ex/arcpath.rb +0 -33
  82. data/doc/ex/arcs01.rb +0 -28
  83. data/doc/ex/arcs02.rb +0 -61
  84. data/doc/ex/average.rb +0 -15
  85. data/doc/ex/axes.rb +0 -64
  86. data/doc/ex/baseline_shift01.rb +0 -18
  87. data/doc/ex/bilevel_channel.rb +0 -9
  88. data/doc/ex/blur_image.rb +0 -12
  89. data/doc/ex/border.rb +0 -10
  90. data/doc/ex/bounding_box.rb +0 -44
  91. data/doc/ex/cbezier1.rb +0 -42
  92. data/doc/ex/cbezier2.rb +0 -42
  93. data/doc/ex/cbezier3.rb +0 -42
  94. data/doc/ex/cbezier4.rb +0 -43
  95. data/doc/ex/cbezier5.rb +0 -43
  96. data/doc/ex/cbezier6.rb +0 -53
  97. data/doc/ex/channel.rb +0 -26
  98. data/doc/ex/charcoal.rb +0 -12
  99. data/doc/ex/chop.rb +0 -29
  100. data/doc/ex/circle.rb +0 -33
  101. data/doc/ex/circle01.rb +0 -17
  102. data/doc/ex/clip_path.rb +0 -60
  103. data/doc/ex/coalesce.rb +0 -60
  104. data/doc/ex/color_fill_to_border.rb +0 -29
  105. data/doc/ex/color_floodfill.rb +0 -28
  106. data/doc/ex/color_histogram.rb +0 -48
  107. data/doc/ex/color_reset.rb +0 -11
  108. data/doc/ex/colorize.rb +0 -16
  109. data/doc/ex/colors.rb +0 -64
  110. data/doc/ex/compose_mask.rb +0 -23
  111. data/doc/ex/composite.rb +0 -135
  112. data/doc/ex/composite_layers.rb +0 -53
  113. data/doc/ex/composite_tiled.rb +0 -23
  114. data/doc/ex/contrast.rb +0 -36
  115. data/doc/ex/crop.rb +0 -31
  116. data/doc/ex/crop_with_gravity.rb +0 -46
  117. data/doc/ex/cubic01.rb +0 -45
  118. data/doc/ex/cubic02.rb +0 -94
  119. data/doc/ex/cycle_colormap.rb +0 -21
  120. data/doc/ex/dissolve.rb +0 -13
  121. data/doc/ex/drawcomp.rb +0 -42
  122. data/doc/ex/drop_shadow.rb +0 -60
  123. data/doc/ex/edge.rb +0 -11
  124. data/doc/ex/ellipse.rb +0 -45
  125. data/doc/ex/ellipse01.rb +0 -22
  126. data/doc/ex/emboss.rb +0 -11
  127. data/doc/ex/enhance.rb +0 -28
  128. data/doc/ex/equalize.rb +0 -11
  129. data/doc/ex/evenodd.rb +0 -43
  130. data/doc/ex/fill_pattern.rb +0 -26
  131. data/doc/ex/flatten_images.rb +0 -36
  132. data/doc/ex/flip.rb +0 -11
  133. data/doc/ex/flop.rb +0 -11
  134. data/doc/ex/font_styles.rb +0 -34
  135. data/doc/ex/fonts.rb +0 -20
  136. data/doc/ex/frame.rb +0 -12
  137. data/doc/ex/gaussian_blur.rb +0 -11
  138. data/doc/ex/get_multiline_type_metrics.rb +0 -42
  139. data/doc/ex/get_pixels.rb +0 -48
  140. data/doc/ex/get_type_metrics.rb +0 -146
  141. data/doc/ex/gradientfill.rb +0 -27
  142. data/doc/ex/grav.rb +0 -46
  143. data/doc/ex/gravity.rb +0 -79
  144. data/doc/ex/group.rb +0 -26
  145. data/doc/ex/hatchfill.rb +0 -27
  146. data/doc/ex/image.rb +0 -46
  147. data/doc/ex/images/Apple.miff +0 -0
  148. data/doc/ex/images/Ballerina.jpg +0 -0
  149. data/doc/ex/images/Ballerina3.jpg +0 -0
  150. data/doc/ex/images/Button_0.gif +0 -0
  151. data/doc/ex/images/Button_1.gif +0 -0
  152. data/doc/ex/images/Button_2.gif +0 -0
  153. data/doc/ex/images/Button_3.gif +0 -0
  154. data/doc/ex/images/Button_4.gif +0 -0
  155. data/doc/ex/images/Button_5.gif +0 -0
  156. data/doc/ex/images/Button_6.gif +0 -0
  157. data/doc/ex/images/Button_7.gif +0 -0
  158. data/doc/ex/images/Button_8.gif +0 -0
  159. data/doc/ex/images/Button_9.gif +0 -0
  160. data/doc/ex/images/Button_A.gif +0 -0
  161. data/doc/ex/images/Button_B.gif +0 -0
  162. data/doc/ex/images/Button_C.gif +0 -0
  163. data/doc/ex/images/Button_D.gif +0 -0
  164. data/doc/ex/images/Button_E.gif +0 -0
  165. data/doc/ex/images/Button_F.gif +0 -0
  166. data/doc/ex/images/Button_G.gif +0 -0
  167. data/doc/ex/images/Button_H.gif +0 -0
  168. data/doc/ex/images/Button_I.gif +0 -0
  169. data/doc/ex/images/Button_J.gif +0 -0
  170. data/doc/ex/images/Button_K.gif +0 -0
  171. data/doc/ex/images/Button_L.gif +0 -0
  172. data/doc/ex/images/Button_M.gif +0 -0
  173. data/doc/ex/images/Button_N.gif +0 -0
  174. data/doc/ex/images/Button_O.gif +0 -0
  175. data/doc/ex/images/Button_P.gif +0 -0
  176. data/doc/ex/images/Button_Q.gif +0 -0
  177. data/doc/ex/images/Button_R.gif +0 -0
  178. data/doc/ex/images/Button_S.gif +0 -0
  179. data/doc/ex/images/Button_T.gif +0 -0
  180. data/doc/ex/images/Button_U.gif +0 -0
  181. data/doc/ex/images/Button_V.gif +0 -0
  182. data/doc/ex/images/Button_W.gif +0 -0
  183. data/doc/ex/images/Button_X.gif +0 -0
  184. data/doc/ex/images/Button_Y.gif +0 -0
  185. data/doc/ex/images/Button_Z.gif +0 -0
  186. data/doc/ex/images/Cheetah.jpg +0 -0
  187. data/doc/ex/images/Coffee.wmf +0 -0
  188. data/doc/ex/images/Flower_Hat.jpg +0 -0
  189. data/doc/ex/images/Gold_Statue.jpg +0 -0
  190. data/doc/ex/images/Hot_Air_Balloons.jpg +0 -0
  191. data/doc/ex/images/Hot_Air_Balloons_H.jpg +0 -0
  192. data/doc/ex/images/Leaf.miff +0 -0
  193. data/doc/ex/images/No.wmf +0 -0
  194. data/doc/ex/images/Polynesia.jpg +0 -0
  195. data/doc/ex/images/Red_Rocks.jpg +0 -0
  196. data/doc/ex/images/Rocks_On_Beach.miff +0 -0
  197. data/doc/ex/images/Shorts.jpg +0 -0
  198. data/doc/ex/images/Snake.wmf +0 -0
  199. data/doc/ex/images/Violin.jpg +0 -0
  200. data/doc/ex/images/Yellow_Rose.miff +0 -0
  201. data/doc/ex/images/big-duck.gif +0 -0
  202. data/doc/ex/images/duck.gif +0 -0
  203. data/doc/ex/images/duck0.gif +0 -0
  204. data/doc/ex/images/duck1.gif +0 -0
  205. data/doc/ex/images/duck10.gif +0 -0
  206. data/doc/ex/images/duck11.gif +0 -0
  207. data/doc/ex/images/duck12.gif +0 -0
  208. data/doc/ex/images/duck13.gif +0 -0
  209. data/doc/ex/images/duck14.gif +0 -0
  210. data/doc/ex/images/duck15.gif +0 -0
  211. data/doc/ex/images/duck2.gif +0 -0
  212. data/doc/ex/images/duck3.gif +0 -0
  213. data/doc/ex/images/duck4.gif +0 -0
  214. data/doc/ex/images/duck5.gif +0 -0
  215. data/doc/ex/images/duck6.gif +0 -0
  216. data/doc/ex/images/duck7.gif +0 -0
  217. data/doc/ex/images/duck8.gif +0 -0
  218. data/doc/ex/images/duck9.gif +0 -0
  219. data/doc/ex/images/graydient230x6.gif +0 -0
  220. data/doc/ex/images/logo400x83.gif +0 -0
  221. data/doc/ex/images/model.miff +0 -0
  222. data/doc/ex/images/notimplemented.gif +0 -0
  223. data/doc/ex/images/smile.miff +0 -0
  224. data/doc/ex/images/spin.gif +0 -0
  225. data/doc/ex/implode.rb +0 -34
  226. data/doc/ex/level.rb +0 -11
  227. data/doc/ex/level_colors.rb +0 -11
  228. data/doc/ex/line.rb +0 -42
  229. data/doc/ex/line01.rb +0 -23
  230. data/doc/ex/mask.rb +0 -36
  231. data/doc/ex/matte_fill_to_border.rb +0 -40
  232. data/doc/ex/matte_floodfill.rb +0 -33
  233. data/doc/ex/matte_replace.rb +0 -40
  234. data/doc/ex/median_filter.rb +0 -28
  235. data/doc/ex/modulate.rb +0 -11
  236. data/doc/ex/mono.rb +0 -23
  237. data/doc/ex/morph.rb +0 -26
  238. data/doc/ex/mosaic.rb +0 -35
  239. data/doc/ex/motion_blur.rb +0 -11
  240. data/doc/ex/negate.rb +0 -11
  241. data/doc/ex/negate_channel.rb +0 -9
  242. data/doc/ex/nested_rvg.rb +0 -21
  243. data/doc/ex/nonzero.rb +0 -43
  244. data/doc/ex/normalize.rb +0 -11
  245. data/doc/ex/oil_paint.rb +0 -11
  246. data/doc/ex/opacity.rb +0 -37
  247. data/doc/ex/ordered_dither.rb +0 -11
  248. data/doc/ex/path.rb +0 -64
  249. data/doc/ex/pattern1.rb +0 -25
  250. data/doc/ex/pattern2.rb +0 -26
  251. data/doc/ex/polaroid.rb +0 -28
  252. data/doc/ex/polygon.rb +0 -24
  253. data/doc/ex/polygon01.rb +0 -23
  254. data/doc/ex/polyline.rb +0 -23
  255. data/doc/ex/polyline01.rb +0 -23
  256. data/doc/ex/posterize.rb +0 -8
  257. data/doc/ex/preview.rb +0 -9
  258. data/doc/ex/qbezierpath.rb +0 -52
  259. data/doc/ex/quad01.rb +0 -36
  260. data/doc/ex/quantize-m.rb +0 -25
  261. data/doc/ex/radial_blur.rb +0 -9
  262. data/doc/ex/raise.rb +0 -8
  263. data/doc/ex/random_threshold_channel.rb +0 -13
  264. data/doc/ex/rect01.rb +0 -15
  265. data/doc/ex/rect02.rb +0 -22
  266. data/doc/ex/rectangle.rb +0 -35
  267. data/doc/ex/reduce_noise.rb +0 -28
  268. data/doc/ex/remap.rb +0 -12
  269. data/doc/ex/remap_images.rb +0 -21
  270. data/doc/ex/resize_to_fill.rb +0 -10
  271. data/doc/ex/resize_to_fit.rb +0 -10
  272. data/doc/ex/roll.rb +0 -9
  273. data/doc/ex/rotate.rb +0 -45
  274. data/doc/ex/rotate_f.rb +0 -14
  275. data/doc/ex/roundrect.rb +0 -34
  276. data/doc/ex/rubyname.rb +0 -30
  277. data/doc/ex/rvg_clippath.rb +0 -14
  278. data/doc/ex/rvg_linecap.rb +0 -43
  279. data/doc/ex/rvg_linejoin.rb +0 -41
  280. data/doc/ex/rvg_opacity.rb +0 -19
  281. data/doc/ex/rvg_pattern.rb +0 -26
  282. data/doc/ex/rvg_stroke_dasharray.rb +0 -12
  283. data/doc/ex/segment.rb +0 -11
  284. data/doc/ex/sepiatone.rb +0 -8
  285. data/doc/ex/shade.rb +0 -11
  286. data/doc/ex/shadow.rb +0 -31
  287. data/doc/ex/shave.rb +0 -15
  288. data/doc/ex/shear.rb +0 -10
  289. data/doc/ex/sketch.rb +0 -18
  290. data/doc/ex/skewx.rb +0 -52
  291. data/doc/ex/skewy.rb +0 -47
  292. data/doc/ex/smile.rb +0 -125
  293. data/doc/ex/solarize.rb +0 -11
  294. data/doc/ex/sparse_color.rb +0 -55
  295. data/doc/ex/splice.rb +0 -9
  296. data/doc/ex/spread.rb +0 -11
  297. data/doc/ex/stegano.rb +0 -55
  298. data/doc/ex/stroke_dasharray.rb +0 -43
  299. data/doc/ex/stroke_fill.rb +0 -11
  300. data/doc/ex/stroke_linecap.rb +0 -44
  301. data/doc/ex/stroke_linejoin.rb +0 -48
  302. data/doc/ex/stroke_width.rb +0 -49
  303. data/doc/ex/swirl.rb +0 -17
  304. data/doc/ex/text.rb +0 -37
  305. data/doc/ex/text01.rb +0 -17
  306. data/doc/ex/text_align.rb +0 -36
  307. data/doc/ex/text_antialias.rb +0 -38
  308. data/doc/ex/text_styles.rb +0 -21
  309. data/doc/ex/text_undercolor.rb +0 -28
  310. data/doc/ex/texture_fill_to_border.rb +0 -34
  311. data/doc/ex/texture_floodfill.rb +0 -32
  312. data/doc/ex/texturefill.rb +0 -25
  313. data/doc/ex/threshold.rb +0 -13
  314. data/doc/ex/to_blob.rb +0 -14
  315. data/doc/ex/translate.rb +0 -39
  316. data/doc/ex/transparent.rb +0 -38
  317. data/doc/ex/transpose.rb +0 -9
  318. data/doc/ex/transverse.rb +0 -9
  319. data/doc/ex/tref01.rb +0 -25
  320. data/doc/ex/triangle01.rb +0 -16
  321. data/doc/ex/trim.rb +0 -24
  322. data/doc/ex/tspan01.rb +0 -18
  323. data/doc/ex/tspan02.rb +0 -19
  324. data/doc/ex/tspan03.rb +0 -21
  325. data/doc/ex/unsharp_mask.rb +0 -28
  326. data/doc/ex/viewex.rb +0 -35
  327. data/doc/ex/vignette.rb +0 -12
  328. data/doc/ex/watermark.rb +0 -28
  329. data/doc/ex/wave.rb +0 -9
  330. data/doc/ex/wet_floor.rb +0 -59
  331. data/doc/ex/writing_mode01.rb +0 -27
  332. data/doc/ex/writing_mode02.rb +0 -26
  333. data/doc/ilist.html +0 -2056
  334. data/doc/image1.html +0 -4680
  335. data/doc/image2.html +0 -3665
  336. data/doc/image3.html +0 -4522
  337. data/doc/imageattrs.html +0 -1638
  338. data/doc/imusage.html +0 -514
  339. data/doc/index.html +0 -416
  340. data/doc/info.html +0 -1499
  341. data/doc/magick.html +0 -565
  342. data/doc/optequiv.html +0 -2435
  343. data/doc/rvg.html +0 -975
  344. data/doc/rvgclip.html +0 -248
  345. data/doc/rvggroup.html +0 -305
  346. data/doc/rvgimage.html +0 -289
  347. data/doc/rvgpattern.html +0 -475
  348. data/doc/rvgshape.html +0 -406
  349. data/doc/rvgstyle.html +0 -270
  350. data/doc/rvgtext.html +0 -465
  351. data/doc/rvgtspan.html +0 -238
  352. data/doc/rvgtut.html +0 -530
  353. data/doc/rvguse.html +0 -145
  354. data/doc/rvgxform.html +0 -294
  355. data/doc/scripts/doc.js +0 -22
  356. data/doc/scripts/stripeTables.js +0 -23
  357. data/doc/struct.html +0 -1339
  358. data/doc/usage.html +0 -1621
  359. data/examples/constitute.rb +0 -7
  360. data/examples/crop_with_gravity.rb +0 -46
  361. data/examples/demo.rb +0 -324
  362. data/examples/describe.rb +0 -44
  363. data/examples/find_similar_region.rb +0 -34
  364. data/examples/histogram.rb +0 -325
  365. data/examples/identify.rb +0 -187
  366. data/examples/image_opacity.rb +0 -29
  367. data/examples/import_export.rb +0 -31
  368. data/examples/pattern_fill.rb +0 -38
  369. data/examples/rotating_text.rb +0 -45
  370. data/examples/spinner.rb +0 -50
  371. data/examples/thumbnail.rb +0 -65
  372. data/examples/vignette.rb +0 -79
  373. data/ext/RMagick/MANIFEST +0 -358
  374. data/lib/RMagick.rb +0 -1962
  375. data/metaconfig +0 -7
  376. data/post-clean.rb +0 -12
  377. data/post-install.rb +0 -50
  378. data/post-setup.rb +0 -254
  379. data/setup.rb +0 -1585
  380. data/uninstall.rb +0 -76
data/doc/index.html DELETED
@@ -1,416 +0,0 @@
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 1 September 2005), see www.w3.org" />
8
-
9
- <title>RMagick 2.13.2 User's Guide and Reference</title>
10
- <meta http-equiv="Content-Type" content=
11
- "text/html; charset=us-ascii" />
12
- <meta name="GENERATOR" content="Quanta Plus" />
13
- <meta name="Copyright" content=
14
- "Copyright (C) 2006 by Timothy P. Hunter" />
15
- <link rel="stylesheet" type="text/css" href="css/doc.css" />
16
- <style type="text/css">
17
- /*<![CDATA[*/
18
-
19
- /* Styles local to this page. */
20
-
21
- #logo {
22
- position: absolute;
23
- top: 0;
24
- left: 0;
25
- width: 100%;
26
- background-color: black;
27
- margin: 0;
28
- }
29
- #logoborder {
30
- margin: 0;
31
- padding-left: 10px;
32
- font-weight: 700;
33
- font-style: italic;
34
- background-color: #900;
35
- color: #c0c0c0;
36
- }
37
- #magick {
38
- position:absolute;
39
- top: 20px;
40
- left: 380px;
41
- padding-left: 15px;
42
- margin-bottom: 0;
43
- color: #c0c0c0;
44
- background-color: black;
45
- font-weight: 700;
46
- font-family: sans-serif;
47
- }
48
- .tm {
49
- vertical-align: super;
50
- font-size: x-small;
51
- }
52
-
53
- h1 {
54
- text-align: left;
55
- background-color: #900;
56
- color: #ebebeb;
57
- padding: 5px .3em .5em .3em;
58
- margin-top: 110px;
59
- margin-bottom: 0;
60
- }
61
-
62
- h2 {
63
- margin-top: 0;
64
- margin-bottom: 0;
65
- padding-left: .3em;
66
- padding-right: .3em;
67
- padding-bottom: .5em;
68
- padding-top: .5em;
69
- background-color: #545454;
70
- color: white;
71
- }
72
-
73
- #toc ul {
74
- padding-top: 1em;
75
- padding-bottom: 1em;
76
- list-style: none;
77
- font-weight: bold;
78
- }
79
- #toc ul ul {
80
- padding-top: 0;
81
- list-style: square;
82
- font-weight: normal;
83
- }
84
- #toc ul ul ul {
85
- list-style: circle;
86
- }
87
-
88
- #Introduction {
89
- background-color: #663;
90
- margin-bottom: 1em;
91
- }
92
-
93
- #version {
94
- padding-top: 1em;
95
- margin-left: 0;
96
- margin-right: 0;
97
- }
98
- /*]]>*/
99
- </style>
100
- </head>
101
-
102
- <body>
103
- <div id="logo">
104
- <img alt="" src="ex/images/logo400x83.gif" />
105
- </div>
106
-
107
- <p id="magick">Ruby+ImageMagick<span class="tm">TM</span><br />
108
- Version 2.13.2</p>
109
-
110
- <h1>User's Guide and Reference</h1>
111
-
112
- <h2>Table of Contents</h2>
113
-
114
- <div id="toc">
115
- <ul>
116
- <li><a href="#introduction">Introduction</a></li>
117
-
118
- <li>User's Guide</li>
119
-
120
- <li style="list-style: none">
121
- <ul>
122
- <li><a href="usage.html">How to Use RMagick</a></li>
123
-
124
- <li><a href="imusage.html">ImageMagick
125
- Conventions</a></li>
126
-
127
- <li><a href="optequiv.html">Magick Command Options and
128
- Their Equivalent Methods</a></li>
129
-
130
- <li><a href="comtasks.html">Common Tasks</a></li>
131
- </ul>
132
- </li>
133
-
134
- <li>Reference</li>
135
-
136
- <li style="list-style: none">
137
- <ul>
138
- <li>Modules</li>
139
-
140
- <li style="list-style: none">
141
- <ul>
142
- <li><a href="magick.html">Magick</a></li>
143
- </ul>
144
- </li>
145
-
146
- <li>Classes</li>
147
-
148
- <li style="list-style: none">
149
- <ul>
150
- <li><a href="ilist.html">ImageList</a></li>
151
-
152
- <li><a href="imageattrs.html">Image (attribute
153
- methods)</a></li>
154
-
155
- <li><a href="image1.html">Image (class methods and
156
- instance methods a-d)</a></li>
157
-
158
- <li><a href="image2.html">Image (instance methods
159
- e-o)</a></li>
160
-
161
- <li><a href="image3.html">Image (instance methods
162
- p-w)</a></li>
163
-
164
- <li><a href="draw.html">Draw</a></li>
165
- </ul>
166
- </li>
167
-
168
- <li>
169
- <a href="struct.html">Miscellaneous classes</a>
170
-
171
- <ul>
172
- <li><a href="struct.html#view">Image::View</a></li>
173
-
174
- <li><a href="struct.html#Geometry">Geometry</a></li>
175
-
176
- <li><a href="struct.html#Pixel">Pixel</a></li>
177
-
178
- <li><a href="struct.html#struct">Struct
179
- classes</a></li>
180
-
181
- <li><a href="struct.html#fill">Fill classes</a></li>
182
-
183
- <li><a href="struct.html#exception">Exception
184
- classes</a></li>
185
- </ul>
186
- </li>
187
-
188
- <li><a href="info.html">Image::Info - Optional method
189
- arguments</a></li>
190
-
191
- <li><a href="constants.html">Constants</a></li>
192
- </ul>
193
- </li>
194
-
195
- <li>RVG - Ruby Vector Graphics</li>
196
-
197
- <li style="list-style:none">
198
- <ul>
199
- <li><a href="rvgtut.html">Drawing with RVG: A
200
- tutorial</a></li>
201
-
202
- <li>RVG Reference
203
-
204
- <ul>
205
- <li><a href="rvg.html">class RVG</a></li>
206
-
207
- <li><a href="rvggroup.html">class RVG::Group</a></li>
208
-
209
- <li><a href="rvgimage.html">class RVG::Image</a></li>
210
-
211
- <li><a href="rvgpattern.html">class
212
- RVG::Pattern</a></li>
213
-
214
- <li><a href="rvgclip.html">class
215
- RVG::ClipPath</a></li>
216
-
217
- <li><a href="rvgtext.html">class RVG::Text</a></li>
218
-
219
- <li><a href="rvgtspan.html">class RVG::Tspan</a></li>
220
-
221
- <li><a href="rvguse.html">class RVG::Use</a></li>
222
-
223
- <li><a href="rvgstyle.html">The styles
224
- method</a></li>
225
-
226
- <li><a href="rvgshape.html">The shapes
227
- methods</a></li>
228
-
229
- <li><a href="rvgxform.html">The transform
230
- methods</a></li>
231
- </ul>
232
- </li>
233
- </ul>
234
- </li>
235
- </ul>
236
- </div>
237
-
238
- <h2 id="introduction">Introduction</h2>
239
-
240
- <h3>What is RMagick?</h3>
241
-
242
- <p>RMagick is a binding from Ruby to the ImageMagick <span class=
243
- "tm">TM</span> image manipulation library. Here's how the
244
- <a href="http://www.imagemagick.org">ImageMagick home page</a>
245
- describes ImageMagick:</p>
246
-
247
- <div class="imquote">
248
- <p>ImageMagick<span style=
249
- "font-size: x-small; vertical-align: super">TM</span>... is a
250
- free software suite to create, edit, and compose bitmap images.
251
- It can read, convert and write images in a large variety of
252
- formats. Images can be cropped, colors can be changed, various
253
- effects can be applied, images can be rotated and combined, and
254
- text, lines, polygons, ellipses and B&eacute;zier curves can be
255
- added to images and stretched and rotated.</p>
256
- </div>
257
-
258
- <p>ImageMagick offers a full range of image processing tools that
259
- provide the capability to:</p>
260
-
261
- <div class="imquote">
262
- <ul>
263
- <li>Convert an image from one format to another (e.g. TIFF to
264
- JPEG)</li>
265
-
266
- <li>Resize, rotate, sharpen, color reduce, or add special
267
- effects to an image</li>
268
-
269
- <li>Create a montage of image thumbnails</li>
270
-
271
- <li>Create a transparent image suitable for use on the
272
- Web</li>
273
-
274
- <li>Turn a group of images into a GIF animation sequence</li>
275
-
276
- <li>Create a composite image by combining several separate
277
- images</li>
278
-
279
- <li>Draw shapes or text on an image</li>
280
-
281
- <li>Decorate an image with a border or frame</li>
282
-
283
- <li>Describe the format and characteristics of an image</li>
284
- </ul>
285
- </div>
286
-
287
- <p>RMagick is a complete interface to ImageMagick. Version 1.0.0
288
- was released in February, 2003. Within its four major classes and
289
- 18 minor classes RMagick defines over 650 methods and 350
290
- constants. RMagick exploits Ruby idioms such as blocks and
291
- iterators, Struct classes, symbols, ?- and !-suffixed methods,
292
- and exceptions.</p>
293
-
294
- <h3>About this document</h3>
295
-
296
- <p>This document describes Version 2.13.2 of RMagick. It is
297
- divided into 4 parts. The first is this page. The second part is
298
- a user's guide covering both RMagick and ImageMagick usage and
299
- conventions. The third part is a reference guide to the
300
- ImageList, Image, and Draw classes. This guide includes many
301
- examples. The fourth part covers Ruby Vector Graphics (RVG). RVG
302
- is a facade for Draw that provides a high-level API for scalable
303
- vector graphics. The RVG section includes a tutorial and complete
304
- reference documentation.</p>
305
-
306
- <p>Accompanying the HTML documentation is a set of over 175
307
- example RMagick programs. Each is a complete, stand-alone program
308
- that either creates an image from scratch or modifies an input
309
- image using one or more RMagick methods. The output images are
310
- used as illustrations in the HTML documentation. Throughout this
311
- document, click any example image to see the program that created
312
- it.</p>
313
-
314
- <h4>Conventions</h4>
315
-
316
- <p><b>Names&nbsp;&nbsp;</b>I've tried to follow existing Ruby
317
- conventions in this document. A class is identified by its name,
318
- which always starts with a capital letter. An object is referred
319
- to by its class name, starting with a small letter. For example,
320
- a generic ImageList object is referred to as an
321
- <em>imagelist</em>. Class methods are identified like this:
322
- <code>Class.method</code>. Instance methods are identified like
323
- this: <code>Class#method</code>.</p>
324
-
325
- <p>RMagick is implemented in the <b>Magick</b> module, therefore
326
- its constants are in the Magick namespace. However, for clarity
327
- I've omitted the <code>Magick::</code> prefix in most places in
328
- this document. You can use the <code>include Magick</code>
329
- statement to add the constants and methods to the Object
330
- namespace.</p>
331
-
332
- <p><b>ImageMagick documentation&nbsp;&nbsp;</b><span class=
333
- "imquote">Text that looks like this</span> is quoted from the
334
- ImageMagick documentation.</p>
335
-
336
- <p><b>Example programs and images&nbsp;&nbsp;</b> All of the
337
- example images on these pages were created by RMagick. Click the
338
- image to see the program code. (You may need to configure your
339
- browser to allow JavaScript and pop-up windows.) All example
340
- images show the result of applying the method. Many example
341
- images show the "before" image as well. When the image is
342
- accompanied by this symbol <img style="display:inline" src=
343
- "ex/images/spin.gif" alt="rollover" /> mouse over the image to
344
- see the "before" version.</p>
345
-
346
- <h3>How to get help</h3>
347
-
348
- <p>If you have a question that is not answered by these pages,
349
- you can post it at the <a href=
350
- "http://rubyforge.org/projects/rmagick">Support Request
351
- Tracker</a> or the <a href=
352
- "http://rubyforge.org/projects/rmagick">Feature Request
353
- Tracker</a> on RubyForge, or email me at <code>rmagick at
354
- rubyforge dot org</code>.</p>
355
-
356
- <h3><a name="bugs" id="bugs">Reporting bugs</a></h3>
357
-
358
- <p>Please report problems with RMagick installation and usage to
359
- the <a href="http://rubyforge.org/projects/rmagick/">Bug
360
- Tracker</a> at RubyForge, or email me at <code>rmagick at
361
- rubyforge dot org</code>.</p>
362
-
363
- <p>For quickest results, include the RMagick, ImageMagick and
364
- Ruby version numbers, along with a thorough description of the
365
- problem. RMagick will tell you both its version number and
366
- ImageMagick's version number. Simply bring up irb and run this
367
- command:</p>
368
- <pre class="example" id="version">
369
- $ ruby -rRMagick -e "puts Magick::Long_version"
370
- This is RMagick 2.0.0 ($Date: 2009/02/28 23:50:16 $) Copyright (C) 2007 by Timothy P. Hunter
371
- Built with ImageMagick 6.3.7 12/20/07 Q16 http://www.imagemagick.org
372
- Built for ruby 1.8.6
373
- Web page: http://rmagick.rubyforge.org
374
- Email: rmagick@rubyforge.org
375
- </pre>
376
-
377
- <p>(Using RubyGems?&nbsp;&nbsp;If you haven't added
378
- <code>rubygems</code> to your RUBYOPT environment variable you
379
- may need to use this command instead: <code>ruby -rubygems -r
380
- RMagick -e "puts Magick::Long_version"</code>.)</p>
381
-
382
- <p>It will help a lot if you supply a small Ruby program that
383
- reproduces the problem. Don't forget to include any input image
384
- files!</p>
385
-
386
- <p>Please remember I can't help with Ruby or ImageMagick
387
- installation and configuration problems. For help with Ruby, post
388
- your questions to <code>comp.lang.ruby</code>. For help with
389
- ImageMagick, you can post to the <a href=
390
- "http://www.imagemagick.org/discourse-server/">ImageMagick
391
- Discourse Server</a>.</p>
392
-
393
- <p>I'm not an image processing guru, either, so I probably won't
394
- be able to help with questions about specific image formats and
395
- transformations. I will be glad, however, to intermediate between
396
- RMagick users and the ImageMagick developers.</p>
397
-
398
- <h3><a name="copyrights" id="copyrights">Copyright
399
- Notices</a></h3>
400
-
401
- <ul>
402
- <li>RMagick &copy; 2002-2009 Timothy P. Hunter.</li>
403
-
404
- <li>ImageMagick &copy; 1999-2009 ImageMagick Studio.</li>
405
-
406
- <li>Ruby is copyrighted free software by Yukihiro
407
- Matsumoto.</li>
408
- </ul>
409
-
410
- <div class="nav">
411
- &laquo; <a href="index.html">Prev</a> | <a href=
412
- "index.html">Contents</a> | <a href="usage.html">Next</a>
413
- &raquo;
414
- </div>
415
- </body>
416
- </html>