rmagick 3.2.0 → 4.3.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 (420) hide show
  1. checksums.yaml +4 -4
  2. data/.codeclimate.yml +63 -0
  3. data/.devcontainer/Dockerfile +14 -0
  4. data/.devcontainer/ImageMagick6/devcontainer.json +11 -0
  5. data/.devcontainer/devcontainer.json +11 -0
  6. data/.devcontainer/setup-repo.sh +10 -0
  7. data/.devcontainer/setup-user.sh +45 -0
  8. data/.editorconfig +3 -0
  9. data/.github/ISSUE_TEMPLATE.md +17 -0
  10. data/.github/workflows/ci.yml +79 -0
  11. data/.gitignore +3 -1
  12. data/.rspec +1 -0
  13. data/.rubocop.yml +24 -0
  14. data/.rubocop_todo.yml +151 -297
  15. data/.yardopts +5 -0
  16. data/CHANGELOG.md +233 -0
  17. data/CODE_OF_CONDUCT.md +122 -7
  18. data/CONTRIBUTING.md +14 -10
  19. data/README.md +326 -0
  20. data/Rakefile +16 -22
  21. data/before_install_linux.sh +22 -28
  22. data/before_install_osx.sh +57 -2
  23. data/ext/RMagick/extconf.rb +149 -105
  24. data/ext/RMagick/rmagick.c +77 -104
  25. data/ext/RMagick/rmagick.h +121 -103
  26. data/ext/RMagick/rmdraw.c +364 -436
  27. data/ext/RMagick/rmenum.c +106 -114
  28. data/ext/RMagick/rmfill.c +149 -70
  29. data/ext/RMagick/rmilist.c +225 -367
  30. data/ext/RMagick/rmimage.c +4751 -4405
  31. data/ext/RMagick/rminfo.c +574 -787
  32. data/ext/RMagick/rmkinfo.c +51 -121
  33. data/ext/RMagick/rmmain.c +454 -286
  34. data/ext/RMagick/rmmontage.c +64 -130
  35. data/ext/RMagick/rmpixel.c +488 -437
  36. data/ext/RMagick/rmstruct.c +83 -96
  37. data/ext/RMagick/rmutil.c +302 -214
  38. data/lib/rmagick/version.rb +1 -1
  39. data/lib/rmagick_internal.rb +138 -93
  40. data/lib/rvg/clippath.rb +2 -1
  41. data/lib/rvg/container.rb +10 -5
  42. data/lib/rvg/describable.rb +1 -1
  43. data/lib/rvg/embellishable.rb +5 -4
  44. data/lib/rvg/misc.rb +15 -12
  45. data/lib/rvg/paint.rb +2 -1
  46. data/lib/rvg/pathdata.rb +12 -11
  47. data/lib/rvg/rvg.rb +12 -8
  48. data/lib/rvg/stylable.rb +9 -7
  49. data/lib/rvg/text.rb +11 -6
  50. data/lib/rvg/transformable.rb +3 -2
  51. data/lib/rvg/units.rb +1 -1
  52. data/rmagick.gemspec +10 -11
  53. metadata +52 -423
  54. data/.appveyor.yml +0 -45
  55. data/.circleci/config.yml +0 -56
  56. data/.ruby-version +0 -1
  57. data/.simplecov +0 -27
  58. data/.travis.yml +0 -62
  59. data/Doxyfile +0 -1514
  60. data/README.textile +0 -259
  61. data/benchmarks/memory/README.md +0 -50
  62. data/benchmarks/memory/image_new.rb +0 -8
  63. data/benchmarks/memory/rmagick.gnuplot +0 -16
  64. data/doc/.cvsignore +0 -1
  65. data/doc/comtasks.html +0 -287
  66. data/doc/constants.html +0 -1581
  67. data/doc/css/doc.css +0 -299
  68. data/doc/css/popup.css +0 -34
  69. data/doc/css/ref.css +0 -67
  70. data/doc/draw.html +0 -3272
  71. data/doc/ex/InitialCoords.rb +0 -22
  72. data/doc/ex/NewCoordSys.rb +0 -30
  73. data/doc/ex/OrigCoordSys.rb +0 -16
  74. data/doc/ex/PreserveAspectRatio.rb +0 -204
  75. data/doc/ex/RotateScale.rb +0 -36
  76. data/doc/ex/Skew.rb +0 -38
  77. data/doc/ex/Use01.rb +0 -15
  78. data/doc/ex/Use02.rb +0 -20
  79. data/doc/ex/Use03.rb +0 -16
  80. data/doc/ex/ViewBox.rb +0 -31
  81. data/doc/ex/adaptive_threshold.rb +0 -9
  82. data/doc/ex/add_noise.rb +0 -16
  83. data/doc/ex/affine.rb +0 -48
  84. data/doc/ex/affine_transform.rb +0 -20
  85. data/doc/ex/arc.rb +0 -49
  86. data/doc/ex/arcpath.rb +0 -32
  87. data/doc/ex/arcs01.rb +0 -28
  88. data/doc/ex/arcs02.rb +0 -59
  89. data/doc/ex/average.rb +0 -15
  90. data/doc/ex/axes.rb +0 -64
  91. data/doc/ex/baseline_shift01.rb +0 -17
  92. data/doc/ex/bilevel_channel.rb +0 -8
  93. data/doc/ex/blur_image.rb +0 -12
  94. data/doc/ex/border.rb +0 -10
  95. data/doc/ex/bounding_box.rb +0 -42
  96. data/doc/ex/cbezier1.rb +0 -41
  97. data/doc/ex/cbezier2.rb +0 -41
  98. data/doc/ex/cbezier3.rb +0 -41
  99. data/doc/ex/cbezier4.rb +0 -42
  100. data/doc/ex/cbezier5.rb +0 -42
  101. data/doc/ex/cbezier6.rb +0 -53
  102. data/doc/ex/channel.rb +0 -25
  103. data/doc/ex/charcoal.rb +0 -12
  104. data/doc/ex/chop.rb +0 -29
  105. data/doc/ex/circle.rb +0 -33
  106. data/doc/ex/circle01.rb +0 -16
  107. data/doc/ex/clip_path.rb +0 -60
  108. data/doc/ex/coalesce.rb +0 -57
  109. data/doc/ex/color_fill_to_border.rb +0 -29
  110. data/doc/ex/color_floodfill.rb +0 -28
  111. data/doc/ex/color_histogram.rb +0 -47
  112. data/doc/ex/color_reset.rb +0 -11
  113. data/doc/ex/colorize.rb +0 -16
  114. data/doc/ex/colors.rb +0 -64
  115. data/doc/ex/compose_mask.rb +0 -22
  116. data/doc/ex/composite.rb +0 -133
  117. data/doc/ex/composite_layers.rb +0 -52
  118. data/doc/ex/composite_tiled.rb +0 -21
  119. data/doc/ex/contrast.rb +0 -36
  120. data/doc/ex/crop.rb +0 -31
  121. data/doc/ex/crop_with_gravity.rb +0 -42
  122. data/doc/ex/cubic01.rb +0 -43
  123. data/doc/ex/cubic02.rb +0 -91
  124. data/doc/ex/cycle_colormap.rb +0 -21
  125. data/doc/ex/dissolve.rb +0 -12
  126. data/doc/ex/drawcomp.rb +0 -41
  127. data/doc/ex/drop_shadow.rb +0 -60
  128. data/doc/ex/edge.rb +0 -11
  129. data/doc/ex/ellipse.rb +0 -45
  130. data/doc/ex/ellipse01.rb +0 -21
  131. data/doc/ex/emboss.rb +0 -11
  132. data/doc/ex/enhance.rb +0 -28
  133. data/doc/ex/equalize.rb +0 -11
  134. data/doc/ex/evenodd.rb +0 -42
  135. data/doc/ex/fill_pattern.rb +0 -23
  136. data/doc/ex/flatten_images.rb +0 -36
  137. data/doc/ex/flip.rb +0 -11
  138. data/doc/ex/flop.rb +0 -11
  139. data/doc/ex/font_styles.rb +0 -32
  140. data/doc/ex/fonts.rb +0 -16
  141. data/doc/ex/frame.rb +0 -12
  142. data/doc/ex/gaussian_blur.rb +0 -11
  143. data/doc/ex/get_multiline_type_metrics.rb +0 -41
  144. data/doc/ex/get_pixels.rb +0 -45
  145. data/doc/ex/get_type_metrics.rb +0 -142
  146. data/doc/ex/gradientfill.rb +0 -27
  147. data/doc/ex/grav.rb +0 -45
  148. data/doc/ex/gravity.rb +0 -78
  149. data/doc/ex/group.rb +0 -26
  150. data/doc/ex/hatchfill.rb +0 -27
  151. data/doc/ex/image.rb +0 -44
  152. data/doc/ex/images/Apple.miff +0 -0
  153. data/doc/ex/images/Ballerina.jpg +0 -0
  154. data/doc/ex/images/Ballerina3.jpg +0 -0
  155. data/doc/ex/images/Button_0.gif +0 -0
  156. data/doc/ex/images/Button_1.gif +0 -0
  157. data/doc/ex/images/Button_2.gif +0 -0
  158. data/doc/ex/images/Button_3.gif +0 -0
  159. data/doc/ex/images/Button_4.gif +0 -0
  160. data/doc/ex/images/Button_5.gif +0 -0
  161. data/doc/ex/images/Button_6.gif +0 -0
  162. data/doc/ex/images/Button_7.gif +0 -0
  163. data/doc/ex/images/Button_8.gif +0 -0
  164. data/doc/ex/images/Button_9.gif +0 -0
  165. data/doc/ex/images/Button_A.gif +0 -0
  166. data/doc/ex/images/Button_B.gif +0 -0
  167. data/doc/ex/images/Button_C.gif +0 -0
  168. data/doc/ex/images/Button_D.gif +0 -0
  169. data/doc/ex/images/Button_E.gif +0 -0
  170. data/doc/ex/images/Button_F.gif +0 -0
  171. data/doc/ex/images/Button_G.gif +0 -0
  172. data/doc/ex/images/Button_H.gif +0 -0
  173. data/doc/ex/images/Button_I.gif +0 -0
  174. data/doc/ex/images/Button_J.gif +0 -0
  175. data/doc/ex/images/Button_K.gif +0 -0
  176. data/doc/ex/images/Button_L.gif +0 -0
  177. data/doc/ex/images/Button_M.gif +0 -0
  178. data/doc/ex/images/Button_N.gif +0 -0
  179. data/doc/ex/images/Button_O.gif +0 -0
  180. data/doc/ex/images/Button_P.gif +0 -0
  181. data/doc/ex/images/Button_Q.gif +0 -0
  182. data/doc/ex/images/Button_R.gif +0 -0
  183. data/doc/ex/images/Button_S.gif +0 -0
  184. data/doc/ex/images/Button_T.gif +0 -0
  185. data/doc/ex/images/Button_U.gif +0 -0
  186. data/doc/ex/images/Button_V.gif +0 -0
  187. data/doc/ex/images/Button_W.gif +0 -0
  188. data/doc/ex/images/Button_X.gif +0 -0
  189. data/doc/ex/images/Button_Y.gif +0 -0
  190. data/doc/ex/images/Button_Z.gif +0 -0
  191. data/doc/ex/images/Cheetah.jpg +0 -0
  192. data/doc/ex/images/Coffee.png +0 -0
  193. data/doc/ex/images/Flower_Hat.jpg +0 -0
  194. data/doc/ex/images/Gold_Statue.jpg +0 -0
  195. data/doc/ex/images/Hot_Air_Balloons.jpg +0 -0
  196. data/doc/ex/images/Hot_Air_Balloons_H.jpg +0 -0
  197. data/doc/ex/images/Leaf.miff +0 -0
  198. data/doc/ex/images/No.png +0 -0
  199. data/doc/ex/images/Polynesia.jpg +0 -0
  200. data/doc/ex/images/Red_Rocks.jpg +0 -0
  201. data/doc/ex/images/Rocks_On_Beach.miff +0 -0
  202. data/doc/ex/images/Shorts.jpg +0 -0
  203. data/doc/ex/images/Snake.png +0 -0
  204. data/doc/ex/images/Violin.jpg +0 -0
  205. data/doc/ex/images/Yellow_Rose.miff +0 -0
  206. data/doc/ex/images/big-duck.gif +0 -0
  207. data/doc/ex/images/duck.gif +0 -0
  208. data/doc/ex/images/duck0.gif +0 -0
  209. data/doc/ex/images/duck1.gif +0 -0
  210. data/doc/ex/images/duck10.gif +0 -0
  211. data/doc/ex/images/duck11.gif +0 -0
  212. data/doc/ex/images/duck12.gif +0 -0
  213. data/doc/ex/images/duck13.gif +0 -0
  214. data/doc/ex/images/duck14.gif +0 -0
  215. data/doc/ex/images/duck15.gif +0 -0
  216. data/doc/ex/images/duck2.gif +0 -0
  217. data/doc/ex/images/duck3.gif +0 -0
  218. data/doc/ex/images/duck4.gif +0 -0
  219. data/doc/ex/images/duck5.gif +0 -0
  220. data/doc/ex/images/duck6.gif +0 -0
  221. data/doc/ex/images/duck7.gif +0 -0
  222. data/doc/ex/images/duck8.gif +0 -0
  223. data/doc/ex/images/duck9.gif +0 -0
  224. data/doc/ex/images/graydient230x6.gif +0 -0
  225. data/doc/ex/images/image_with_profile.jpg +0 -0
  226. data/doc/ex/images/logo400x83.gif +0 -0
  227. data/doc/ex/images/model.miff +0 -0
  228. data/doc/ex/images/notimplemented.gif +0 -0
  229. data/doc/ex/images/smile.miff +0 -0
  230. data/doc/ex/images/spin.gif +0 -0
  231. data/doc/ex/implode.rb +0 -34
  232. data/doc/ex/level.rb +0 -11
  233. data/doc/ex/level_colors.rb +0 -11
  234. data/doc/ex/line.rb +0 -41
  235. data/doc/ex/line01.rb +0 -21
  236. data/doc/ex/mask.rb +0 -35
  237. data/doc/ex/matte_fill_to_border.rb +0 -39
  238. data/doc/ex/matte_floodfill.rb +0 -32
  239. data/doc/ex/matte_replace.rb +0 -39
  240. data/doc/ex/median_filter.rb +0 -28
  241. data/doc/ex/modulate.rb +0 -11
  242. data/doc/ex/mono.rb +0 -23
  243. data/doc/ex/morph.rb +0 -25
  244. data/doc/ex/mosaic.rb +0 -37
  245. data/doc/ex/motion_blur.rb +0 -11
  246. data/doc/ex/negate.rb +0 -11
  247. data/doc/ex/negate_channel.rb +0 -9
  248. data/doc/ex/nested_rvg.rb +0 -21
  249. data/doc/ex/nonzero.rb +0 -42
  250. data/doc/ex/normalize.rb +0 -11
  251. data/doc/ex/oil_paint.rb +0 -11
  252. data/doc/ex/opacity.rb +0 -37
  253. data/doc/ex/ordered_dither.rb +0 -11
  254. data/doc/ex/path.rb +0 -63
  255. data/doc/ex/pattern1.rb +0 -25
  256. data/doc/ex/pattern2.rb +0 -26
  257. data/doc/ex/polaroid.rb +0 -26
  258. data/doc/ex/polygon.rb +0 -23
  259. data/doc/ex/polygon01.rb +0 -21
  260. data/doc/ex/polyline.rb +0 -22
  261. data/doc/ex/polyline01.rb +0 -21
  262. data/doc/ex/posterize.rb +0 -8
  263. data/doc/ex/preview.rb +0 -8
  264. data/doc/ex/qbezierpath.rb +0 -52
  265. data/doc/ex/quad01.rb +0 -34
  266. data/doc/ex/quantize-m.rb +0 -25
  267. data/doc/ex/radial_blur.rb +0 -9
  268. data/doc/ex/raise.rb +0 -8
  269. data/doc/ex/random_threshold_channel.rb +0 -13
  270. data/doc/ex/rect01.rb +0 -14
  271. data/doc/ex/rect02.rb +0 -20
  272. data/doc/ex/rectangle.rb +0 -34
  273. data/doc/ex/reduce_noise.rb +0 -28
  274. data/doc/ex/remap.rb +0 -11
  275. data/doc/ex/remap_images.rb +0 -19
  276. data/doc/ex/resize_to_fill.rb +0 -8
  277. data/doc/ex/resize_to_fit.rb +0 -8
  278. data/doc/ex/roll.rb +0 -9
  279. data/doc/ex/rotate.rb +0 -44
  280. data/doc/ex/rotate_f.rb +0 -14
  281. data/doc/ex/roundrect.rb +0 -33
  282. data/doc/ex/rubyname.rb +0 -30
  283. data/doc/ex/rvg_clippath.rb +0 -12
  284. data/doc/ex/rvg_linecap.rb +0 -42
  285. data/doc/ex/rvg_linejoin.rb +0 -40
  286. data/doc/ex/rvg_opacity.rb +0 -18
  287. data/doc/ex/rvg_pattern.rb +0 -26
  288. data/doc/ex/rvg_stroke_dasharray.rb +0 -11
  289. data/doc/ex/segment.rb +0 -11
  290. data/doc/ex/sepiatone.rb +0 -7
  291. data/doc/ex/shade.rb +0 -11
  292. data/doc/ex/shadow.rb +0 -30
  293. data/doc/ex/shave.rb +0 -15
  294. data/doc/ex/shear.rb +0 -10
  295. data/doc/ex/sketch.rb +0 -17
  296. data/doc/ex/skewx.rb +0 -51
  297. data/doc/ex/skewy.rb +0 -47
  298. data/doc/ex/smile.rb +0 -126
  299. data/doc/ex/solarize.rb +0 -11
  300. data/doc/ex/sparse_color.rb +0 -55
  301. data/doc/ex/splice.rb +0 -8
  302. data/doc/ex/spread.rb +0 -11
  303. data/doc/ex/stegano.rb +0 -54
  304. data/doc/ex/stroke_dasharray.rb +0 -42
  305. data/doc/ex/stroke_fill.rb +0 -10
  306. data/doc/ex/stroke_linecap.rb +0 -44
  307. data/doc/ex/stroke_linejoin.rb +0 -48
  308. data/doc/ex/stroke_width.rb +0 -49
  309. data/doc/ex/swirl.rb +0 -17
  310. data/doc/ex/text.rb +0 -37
  311. data/doc/ex/text01.rb +0 -16
  312. data/doc/ex/text_align.rb +0 -36
  313. data/doc/ex/text_antialias.rb +0 -37
  314. data/doc/ex/text_styles.rb +0 -19
  315. data/doc/ex/text_undercolor.rb +0 -28
  316. data/doc/ex/texture_fill_to_border.rb +0 -34
  317. data/doc/ex/texture_floodfill.rb +0 -32
  318. data/doc/ex/texturefill.rb +0 -24
  319. data/doc/ex/threshold.rb +0 -13
  320. data/doc/ex/to_blob.rb +0 -13
  321. data/doc/ex/translate.rb +0 -39
  322. data/doc/ex/transparent.rb +0 -38
  323. data/doc/ex/transpose.rb +0 -9
  324. data/doc/ex/transverse.rb +0 -9
  325. data/doc/ex/tref01.rb +0 -24
  326. data/doc/ex/triangle01.rb +0 -15
  327. data/doc/ex/trim.rb +0 -23
  328. data/doc/ex/tspan01.rb +0 -17
  329. data/doc/ex/tspan02.rb +0 -17
  330. data/doc/ex/tspan03.rb +0 -19
  331. data/doc/ex/unsharp_mask.rb +0 -28
  332. data/doc/ex/viewex.rb +0 -33
  333. data/doc/ex/vignette.rb +0 -12
  334. data/doc/ex/watermark.rb +0 -27
  335. data/doc/ex/wave.rb +0 -9
  336. data/doc/ex/wet_floor.rb +0 -58
  337. data/doc/ex/writing_mode01.rb +0 -26
  338. data/doc/ex/writing_mode02.rb +0 -26
  339. data/doc/ilist.html +0 -2056
  340. data/doc/image1.html +0 -4680
  341. data/doc/image2.html +0 -3665
  342. data/doc/image3.html +0 -4522
  343. data/doc/imageattrs.html +0 -1638
  344. data/doc/imusage.html +0 -514
  345. data/doc/index.html +0 -416
  346. data/doc/info.html +0 -1499
  347. data/doc/magick.html +0 -570
  348. data/doc/optequiv.html +0 -2435
  349. data/doc/rvg.html +0 -975
  350. data/doc/rvgclip.html +0 -248
  351. data/doc/rvggroup.html +0 -305
  352. data/doc/rvgimage.html +0 -289
  353. data/doc/rvgpattern.html +0 -475
  354. data/doc/rvgshape.html +0 -406
  355. data/doc/rvgstyle.html +0 -270
  356. data/doc/rvgtext.html +0 -465
  357. data/doc/rvgtspan.html +0 -238
  358. data/doc/rvgtut.html +0 -530
  359. data/doc/rvguse.html +0 -145
  360. data/doc/rvgxform.html +0 -294
  361. data/doc/scripts/doc.js +0 -22
  362. data/doc/scripts/stripeTables.js +0 -23
  363. data/doc/struct.html +0 -1339
  364. data/doc/usage.html +0 -1621
  365. data/examples/constitute.rb +0 -7
  366. data/examples/crop_with_gravity.rb +0 -42
  367. data/examples/demo.rb +0 -323
  368. data/examples/describe.rb +0 -41
  369. data/examples/find_similar_region.rb +0 -34
  370. data/examples/histogram.rb +0 -312
  371. data/examples/identify.rb +0 -174
  372. data/examples/image_opacity.rb +0 -28
  373. data/examples/import_export.rb +0 -31
  374. data/examples/pattern_fill.rb +0 -37
  375. data/examples/rotating_text.rb +0 -45
  376. data/examples/spinner.rb +0 -49
  377. data/examples/thumbnail.rb +0 -64
  378. data/examples/vignette.rb +0 -78
  379. data/lib/obsolete.rb +0 -66
  380. data/spec/rmagick/ImageList1_spec.rb +0 -24
  381. data/spec/rmagick/draw_spec.rb +0 -155
  382. data/spec/rmagick/image/blue_shift_spec.rb +0 -14
  383. data/spec/rmagick/image/channel_entropy_spec.rb +0 -9
  384. data/spec/rmagick/image/composite_spec.rb +0 -72
  385. data/spec/rmagick/image/constitute_spec.rb +0 -13
  386. data/spec/rmagick/image/dispatch_spec.rb +0 -16
  387. data/spec/rmagick/image/from_blob_spec.rb +0 -12
  388. data/spec/rmagick/image/ping_spec.rb +0 -12
  389. data/spec/rmagick/image/properties_spec.rb +0 -27
  390. data/spec/rmagick/image/read_spec.rb +0 -28
  391. data/spec/spec_helper.rb +0 -10
  392. data/spec/support/issue_200/app.rb +0 -8
  393. data/test/Draw.rb +0 -351
  394. data/test/Enum.rb +0 -228
  395. data/test/Fill.rb +0 -93
  396. data/test/Image1.rb +0 -627
  397. data/test/Image2.rb +0 -1426
  398. data/test/Image3.rb +0 -1091
  399. data/test/ImageList1.rb +0 -858
  400. data/test/ImageList2.rb +0 -406
  401. data/test/Image_attributes.rb +0 -666
  402. data/test/Import_Export.rb +0 -115
  403. data/test/Info.rb +0 -444
  404. data/test/KernelInfo.rb +0 -67
  405. data/test/Magick.rb +0 -311
  406. data/test/Pixel.rb +0 -285
  407. data/test/PolaroidOptions.rb +0 -23
  408. data/test/Preview.rb +0 -26
  409. data/test/Struct.rb +0 -45
  410. data/test/appearance/Montage.rb +0 -26
  411. data/test/appearance/appearance_assertion.rb +0 -13
  412. data/test/appearance/expected/montage_border_color.jpg +0 -0
  413. data/test/cmyk.icm +0 -0
  414. data/test/lib/Obsolete.rb +0 -30
  415. data/test/lib/internal/Draw.rb +0 -823
  416. data/test/lib/internal/Geometry.rb +0 -98
  417. data/test/lib/internal/Magick.rb +0 -40
  418. data/test/srgb.icm +0 -0
  419. data/test/test_all_basic.rb +0 -49
  420. data/test/tmpnam_test.rb +0 -50
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 0.0.0 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 0.0.0</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 0.0.0 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>