rmagick 2.16.0 → 5.5.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/.devcontainer/Dockerfile +14 -0
- data/.devcontainer/ImageMagick6/devcontainer.json +11 -0
- data/.devcontainer/devcontainer.json +11 -0
- data/.devcontainer/setup-repo.sh +10 -0
- data/.devcontainer/setup-user.sh +45 -0
- data/.editorconfig +3 -0
- data/.github/ISSUE_TEMPLATE.md +17 -0
- data/.github/workflows/ci.yml +157 -0
- data/.gitignore +9 -1
- data/.rspec +1 -0
- data/.rubocop.yml +37 -340
- data/.rubocop_todo.yml +456 -0
- data/.yardopts +5 -0
- data/CHANGELOG.md +536 -0
- data/CODE_OF_CONDUCT.md +122 -7
- data/CONTRIBUTING.md +37 -6
- data/Gemfile +18 -4
- data/README.md +319 -0
- data/Rakefile +83 -98
- data/before_install_linux.sh +65 -28
- data/before_install_osx.sh +58 -2
- data/ext/RMagick/extconf.rb +310 -393
- data/ext/RMagick/{rmagick.c → rmagick.cpp} +119 -127
- data/ext/RMagick/rmagick.h +290 -363
- data/ext/RMagick/rmagick_gvl.h +224 -0
- data/ext/RMagick/rmdraw.cpp +1696 -0
- data/ext/RMagick/rmenum.cpp +796 -0
- data/ext/RMagick/{rmfill.c → rmfill.cpp} +287 -197
- data/ext/RMagick/rmilist.cpp +1275 -0
- data/ext/RMagick/rmimage.cpp +16459 -0
- data/ext/RMagick/{rminfo.c → rminfo.cpp} +738 -910
- data/ext/RMagick/rmkinfo.cpp +210 -0
- data/ext/RMagick/rmmain.cpp +1923 -0
- data/ext/RMagick/rmmontage.cpp +474 -0
- data/ext/RMagick/rmpixel.cpp +1322 -0
- data/ext/RMagick/{rmstruct.c → rmstruct.cpp} +104 -284
- data/ext/RMagick/{rmutil.c → rmutil.cpp} +500 -433
- data/lib/rmagick/version.rb +5 -4
- data/lib/rmagick.rb +2 -0
- data/lib/rmagick_internal.rb +397 -459
- data/lib/rvg/clippath.rb +3 -4
- data/lib/rvg/container.rb +30 -22
- data/lib/rvg/deep_equal.rb +11 -11
- data/lib/rvg/describable.rb +2 -2
- data/lib/rvg/embellishable.rb +67 -68
- data/lib/rvg/misc.rb +139 -142
- data/lib/rvg/paint.rb +2 -1
- data/lib/rvg/pathdata.rb +7 -8
- data/lib/rvg/rvg.rb +49 -46
- data/lib/rvg/stretchable.rb +22 -28
- data/lib/rvg/stylable.rb +12 -10
- data/lib/rvg/text.rb +169 -165
- data/lib/rvg/transformable.rb +17 -16
- data/lib/rvg/units.rb +5 -5
- data/rmagick.gemspec +7 -41
- data/sig/rmagick/_draw_common_methods.rbs +64 -0
- data/sig/rmagick/_image_common_methods.rbs +389 -0
- data/sig/rmagick/draw.rbs +38 -0
- data/sig/rmagick/draw_attribute.rbs +28 -0
- data/sig/rmagick/enum.rbs +814 -0
- data/sig/rmagick/error.rbs +11 -0
- data/sig/rmagick/fill.rbs +21 -0
- data/sig/rmagick/geometry.rbs +14 -0
- data/sig/rmagick/image.rbs +194 -0
- data/sig/rmagick/image_list.rbs +181 -0
- data/sig/rmagick/iptc.rbs +101 -0
- data/sig/rmagick/kernel_info.rbs +12 -0
- data/sig/rmagick/optional_method_arguments.rbs +10 -0
- data/sig/rmagick/pixel.rbs +46 -0
- data/sig/rmagick/struct.rbs +90 -0
- data/sig/rmagick.rbs +43 -0
- data/sig/rvg/clippath.rbs +34 -0
- data/sig/rvg/container.rbs +78 -0
- data/sig/rvg/deep_equal.rbs +48 -0
- data/sig/rvg/describable.rbs +30 -0
- data/sig/rvg/embellishable.rbs +226 -0
- data/sig/rvg/misc.rbs +145 -0
- data/sig/rvg/paint.rbs +55 -0
- data/sig/rvg/pathdata.rbs +77 -0
- data/sig/rvg/rvg.rbs +125 -0
- data/sig/rvg/stretchable.rbs +56 -0
- data/sig/rvg/stylable.rbs +66 -0
- data/sig/rvg/text.rbs +118 -0
- data/sig/rvg/transformable.rbs +59 -0
- data/sig/rvg/units.rbs +33 -0
- metadata +68 -428
- data/.hound.yml +0 -2
- data/.simplecov +0 -27
- data/.travis.yml +0 -74
- data/Doxyfile +0 -1514
- data/README.textile +0 -251
- data/deprecated/RMagick.rb +0 -6
- data/doc/.cvsignore +0 -1
- data/doc/comtasks.html +0 -287
- data/doc/constants.html +0 -1581
- data/doc/css/doc.css +0 -299
- data/doc/css/popup.css +0 -34
- data/doc/css/ref.css +0 -67
- data/doc/draw.html +0 -3272
- data/doc/ex/InitialCoords.rb +0 -22
- data/doc/ex/NewCoordSys.rb +0 -30
- data/doc/ex/OrigCoordSys.rb +0 -16
- data/doc/ex/PreserveAspectRatio.rb +0 -204
- data/doc/ex/RotateScale.rb +0 -36
- data/doc/ex/Skew.rb +0 -38
- data/doc/ex/Use01.rb +0 -15
- data/doc/ex/Use02.rb +0 -20
- data/doc/ex/Use03.rb +0 -16
- data/doc/ex/ViewBox.rb +0 -31
- data/doc/ex/adaptive_threshold.rb +0 -9
- data/doc/ex/add_noise.rb +0 -16
- data/doc/ex/affine.rb +0 -48
- data/doc/ex/affine_transform.rb +0 -20
- data/doc/ex/arc.rb +0 -49
- data/doc/ex/arcpath.rb +0 -32
- data/doc/ex/arcs01.rb +0 -28
- data/doc/ex/arcs02.rb +0 -59
- data/doc/ex/average.rb +0 -15
- data/doc/ex/axes.rb +0 -64
- data/doc/ex/baseline_shift01.rb +0 -17
- data/doc/ex/bilevel_channel.rb +0 -8
- data/doc/ex/blur_image.rb +0 -12
- data/doc/ex/border.rb +0 -10
- data/doc/ex/bounding_box.rb +0 -42
- data/doc/ex/cbezier1.rb +0 -41
- data/doc/ex/cbezier2.rb +0 -41
- data/doc/ex/cbezier3.rb +0 -41
- data/doc/ex/cbezier4.rb +0 -42
- data/doc/ex/cbezier5.rb +0 -42
- data/doc/ex/cbezier6.rb +0 -53
- data/doc/ex/channel.rb +0 -25
- data/doc/ex/charcoal.rb +0 -12
- data/doc/ex/chop.rb +0 -29
- data/doc/ex/circle.rb +0 -33
- data/doc/ex/circle01.rb +0 -16
- data/doc/ex/clip_path.rb +0 -60
- data/doc/ex/coalesce.rb +0 -57
- data/doc/ex/color_fill_to_border.rb +0 -29
- data/doc/ex/color_floodfill.rb +0 -28
- data/doc/ex/color_histogram.rb +0 -47
- data/doc/ex/color_reset.rb +0 -11
- data/doc/ex/colorize.rb +0 -16
- data/doc/ex/colors.rb +0 -64
- data/doc/ex/compose_mask.rb +0 -22
- data/doc/ex/composite.rb +0 -133
- data/doc/ex/composite_layers.rb +0 -53
- data/doc/ex/composite_tiled.rb +0 -21
- data/doc/ex/contrast.rb +0 -36
- data/doc/ex/crop.rb +0 -31
- data/doc/ex/crop_with_gravity.rb +0 -42
- data/doc/ex/cubic01.rb +0 -43
- data/doc/ex/cubic02.rb +0 -91
- data/doc/ex/cycle_colormap.rb +0 -21
- data/doc/ex/dissolve.rb +0 -12
- data/doc/ex/drawcomp.rb +0 -42
- data/doc/ex/drop_shadow.rb +0 -60
- data/doc/ex/edge.rb +0 -11
- data/doc/ex/ellipse.rb +0 -45
- data/doc/ex/ellipse01.rb +0 -21
- data/doc/ex/emboss.rb +0 -11
- data/doc/ex/enhance.rb +0 -28
- data/doc/ex/equalize.rb +0 -11
- data/doc/ex/evenodd.rb +0 -42
- data/doc/ex/fill_pattern.rb +0 -23
- data/doc/ex/flatten_images.rb +0 -36
- data/doc/ex/flip.rb +0 -11
- data/doc/ex/flop.rb +0 -11
- data/doc/ex/font_styles.rb +0 -32
- data/doc/ex/fonts.rb +0 -20
- data/doc/ex/frame.rb +0 -12
- data/doc/ex/gaussian_blur.rb +0 -11
- data/doc/ex/get_multiline_type_metrics.rb +0 -41
- data/doc/ex/get_pixels.rb +0 -47
- data/doc/ex/get_type_metrics.rb +0 -141
- data/doc/ex/gradientfill.rb +0 -27
- data/doc/ex/grav.rb +0 -45
- data/doc/ex/gravity.rb +0 -80
- data/doc/ex/group.rb +0 -26
- data/doc/ex/hatchfill.rb +0 -27
- data/doc/ex/image.rb +0 -44
- data/doc/ex/images/Apple.miff +0 -0
- data/doc/ex/images/Ballerina.jpg +0 -0
- data/doc/ex/images/Ballerina3.jpg +0 -0
- data/doc/ex/images/Button_0.gif +0 -0
- data/doc/ex/images/Button_1.gif +0 -0
- data/doc/ex/images/Button_2.gif +0 -0
- data/doc/ex/images/Button_3.gif +0 -0
- data/doc/ex/images/Button_4.gif +0 -0
- data/doc/ex/images/Button_5.gif +0 -0
- data/doc/ex/images/Button_6.gif +0 -0
- data/doc/ex/images/Button_7.gif +0 -0
- data/doc/ex/images/Button_8.gif +0 -0
- data/doc/ex/images/Button_9.gif +0 -0
- data/doc/ex/images/Button_A.gif +0 -0
- data/doc/ex/images/Button_B.gif +0 -0
- data/doc/ex/images/Button_C.gif +0 -0
- data/doc/ex/images/Button_D.gif +0 -0
- data/doc/ex/images/Button_E.gif +0 -0
- data/doc/ex/images/Button_F.gif +0 -0
- data/doc/ex/images/Button_G.gif +0 -0
- data/doc/ex/images/Button_H.gif +0 -0
- data/doc/ex/images/Button_I.gif +0 -0
- data/doc/ex/images/Button_J.gif +0 -0
- data/doc/ex/images/Button_K.gif +0 -0
- data/doc/ex/images/Button_L.gif +0 -0
- data/doc/ex/images/Button_M.gif +0 -0
- data/doc/ex/images/Button_N.gif +0 -0
- data/doc/ex/images/Button_O.gif +0 -0
- data/doc/ex/images/Button_P.gif +0 -0
- data/doc/ex/images/Button_Q.gif +0 -0
- data/doc/ex/images/Button_R.gif +0 -0
- data/doc/ex/images/Button_S.gif +0 -0
- data/doc/ex/images/Button_T.gif +0 -0
- data/doc/ex/images/Button_U.gif +0 -0
- data/doc/ex/images/Button_V.gif +0 -0
- data/doc/ex/images/Button_W.gif +0 -0
- data/doc/ex/images/Button_X.gif +0 -0
- data/doc/ex/images/Button_Y.gif +0 -0
- data/doc/ex/images/Button_Z.gif +0 -0
- data/doc/ex/images/Cheetah.jpg +0 -0
- data/doc/ex/images/Coffee.wmf +0 -0
- data/doc/ex/images/Flower_Hat.jpg +0 -0
- data/doc/ex/images/Gold_Statue.jpg +0 -0
- data/doc/ex/images/Hot_Air_Balloons.jpg +0 -0
- data/doc/ex/images/Hot_Air_Balloons_H.jpg +0 -0
- data/doc/ex/images/Leaf.miff +0 -0
- data/doc/ex/images/No.wmf +0 -0
- data/doc/ex/images/Polynesia.jpg +0 -0
- data/doc/ex/images/Red_Rocks.jpg +0 -0
- data/doc/ex/images/Rocks_On_Beach.miff +0 -0
- data/doc/ex/images/Shorts.jpg +0 -0
- data/doc/ex/images/Snake.wmf +0 -0
- data/doc/ex/images/Violin.jpg +0 -0
- data/doc/ex/images/Yellow_Rose.miff +0 -0
- data/doc/ex/images/big-duck.gif +0 -0
- data/doc/ex/images/duck.gif +0 -0
- data/doc/ex/images/duck0.gif +0 -0
- data/doc/ex/images/duck1.gif +0 -0
- data/doc/ex/images/duck10.gif +0 -0
- data/doc/ex/images/duck11.gif +0 -0
- data/doc/ex/images/duck12.gif +0 -0
- data/doc/ex/images/duck13.gif +0 -0
- data/doc/ex/images/duck14.gif +0 -0
- data/doc/ex/images/duck15.gif +0 -0
- data/doc/ex/images/duck2.gif +0 -0
- data/doc/ex/images/duck3.gif +0 -0
- data/doc/ex/images/duck4.gif +0 -0
- data/doc/ex/images/duck5.gif +0 -0
- data/doc/ex/images/duck6.gif +0 -0
- data/doc/ex/images/duck7.gif +0 -0
- data/doc/ex/images/duck8.gif +0 -0
- data/doc/ex/images/duck9.gif +0 -0
- data/doc/ex/images/graydient230x6.gif +0 -0
- data/doc/ex/images/image_with_profile.jpg +0 -0
- data/doc/ex/images/logo400x83.gif +0 -0
- data/doc/ex/images/model.miff +0 -0
- data/doc/ex/images/notimplemented.gif +0 -0
- data/doc/ex/images/smile.miff +0 -0
- data/doc/ex/images/spin.gif +0 -0
- data/doc/ex/implode.rb +0 -34
- data/doc/ex/level.rb +0 -11
- data/doc/ex/level_colors.rb +0 -11
- data/doc/ex/line.rb +0 -41
- data/doc/ex/line01.rb +0 -21
- data/doc/ex/mask.rb +0 -35
- data/doc/ex/matte_fill_to_border.rb +0 -39
- data/doc/ex/matte_floodfill.rb +0 -32
- data/doc/ex/matte_replace.rb +0 -39
- data/doc/ex/median_filter.rb +0 -28
- data/doc/ex/modulate.rb +0 -11
- data/doc/ex/mono.rb +0 -23
- data/doc/ex/morph.rb +0 -25
- data/doc/ex/mosaic.rb +0 -35
- data/doc/ex/motion_blur.rb +0 -11
- data/doc/ex/negate.rb +0 -11
- data/doc/ex/negate_channel.rb +0 -9
- data/doc/ex/nested_rvg.rb +0 -21
- data/doc/ex/nonzero.rb +0 -42
- data/doc/ex/normalize.rb +0 -11
- data/doc/ex/oil_paint.rb +0 -11
- data/doc/ex/opacity.rb +0 -37
- data/doc/ex/ordered_dither.rb +0 -11
- data/doc/ex/path.rb +0 -63
- data/doc/ex/pattern1.rb +0 -25
- data/doc/ex/pattern2.rb +0 -26
- data/doc/ex/polaroid.rb +0 -27
- data/doc/ex/polygon.rb +0 -23
- data/doc/ex/polygon01.rb +0 -21
- data/doc/ex/polyline.rb +0 -22
- data/doc/ex/polyline01.rb +0 -21
- data/doc/ex/posterize.rb +0 -8
- data/doc/ex/preview.rb +0 -8
- data/doc/ex/qbezierpath.rb +0 -52
- data/doc/ex/quad01.rb +0 -34
- data/doc/ex/quantize-m.rb +0 -25
- data/doc/ex/radial_blur.rb +0 -9
- data/doc/ex/raise.rb +0 -8
- data/doc/ex/random_threshold_channel.rb +0 -13
- data/doc/ex/rect01.rb +0 -14
- data/doc/ex/rect02.rb +0 -20
- data/doc/ex/rectangle.rb +0 -34
- data/doc/ex/reduce_noise.rb +0 -28
- data/doc/ex/remap.rb +0 -11
- data/doc/ex/remap_images.rb +0 -19
- data/doc/ex/resize_to_fill.rb +0 -8
- data/doc/ex/resize_to_fit.rb +0 -8
- data/doc/ex/roll.rb +0 -9
- data/doc/ex/rotate.rb +0 -44
- data/doc/ex/rotate_f.rb +0 -14
- data/doc/ex/roundrect.rb +0 -33
- data/doc/ex/rubyname.rb +0 -30
- data/doc/ex/rvg_clippath.rb +0 -12
- data/doc/ex/rvg_linecap.rb +0 -42
- data/doc/ex/rvg_linejoin.rb +0 -40
- data/doc/ex/rvg_opacity.rb +0 -18
- data/doc/ex/rvg_pattern.rb +0 -26
- data/doc/ex/rvg_stroke_dasharray.rb +0 -11
- data/doc/ex/segment.rb +0 -11
- data/doc/ex/sepiatone.rb +0 -7
- data/doc/ex/shade.rb +0 -11
- data/doc/ex/shadow.rb +0 -30
- data/doc/ex/shave.rb +0 -15
- data/doc/ex/shear.rb +0 -10
- data/doc/ex/sketch.rb +0 -17
- data/doc/ex/skewx.rb +0 -51
- data/doc/ex/skewy.rb +0 -47
- data/doc/ex/smile.rb +0 -125
- data/doc/ex/solarize.rb +0 -11
- data/doc/ex/sparse_color.rb +0 -54
- data/doc/ex/splice.rb +0 -8
- data/doc/ex/spread.rb +0 -11
- data/doc/ex/stegano.rb +0 -55
- data/doc/ex/stroke_dasharray.rb +0 -42
- data/doc/ex/stroke_fill.rb +0 -10
- data/doc/ex/stroke_linecap.rb +0 -44
- data/doc/ex/stroke_linejoin.rb +0 -48
- data/doc/ex/stroke_width.rb +0 -49
- data/doc/ex/swirl.rb +0 -17
- data/doc/ex/text.rb +0 -37
- data/doc/ex/text01.rb +0 -16
- data/doc/ex/text_align.rb +0 -36
- data/doc/ex/text_antialias.rb +0 -37
- data/doc/ex/text_styles.rb +0 -19
- data/doc/ex/text_undercolor.rb +0 -28
- data/doc/ex/texture_fill_to_border.rb +0 -34
- data/doc/ex/texture_floodfill.rb +0 -32
- data/doc/ex/texturefill.rb +0 -24
- data/doc/ex/threshold.rb +0 -13
- data/doc/ex/to_blob.rb +0 -13
- data/doc/ex/translate.rb +0 -39
- data/doc/ex/transparent.rb +0 -38
- data/doc/ex/transpose.rb +0 -9
- data/doc/ex/transverse.rb +0 -9
- data/doc/ex/tref01.rb +0 -24
- data/doc/ex/triangle01.rb +0 -15
- data/doc/ex/trim.rb +0 -23
- data/doc/ex/tspan01.rb +0 -17
- data/doc/ex/tspan02.rb +0 -17
- data/doc/ex/tspan03.rb +0 -19
- data/doc/ex/unsharp_mask.rb +0 -28
- data/doc/ex/viewex.rb +0 -33
- data/doc/ex/vignette.rb +0 -12
- data/doc/ex/watermark.rb +0 -27
- data/doc/ex/wave.rb +0 -9
- data/doc/ex/wet_floor.rb +0 -58
- data/doc/ex/writing_mode01.rb +0 -26
- data/doc/ex/writing_mode02.rb +0 -26
- data/doc/ilist.html +0 -2056
- data/doc/image1.html +0 -4680
- data/doc/image2.html +0 -3665
- data/doc/image3.html +0 -4522
- data/doc/imageattrs.html +0 -1638
- data/doc/imusage.html +0 -514
- data/doc/index.html +0 -416
- data/doc/info.html +0 -1499
- data/doc/magick.html +0 -565
- data/doc/optequiv.html +0 -2435
- data/doc/rvg.html +0 -975
- data/doc/rvgclip.html +0 -248
- data/doc/rvggroup.html +0 -305
- data/doc/rvgimage.html +0 -289
- data/doc/rvgpattern.html +0 -475
- data/doc/rvgshape.html +0 -406
- data/doc/rvgstyle.html +0 -270
- data/doc/rvgtext.html +0 -465
- data/doc/rvgtspan.html +0 -238
- data/doc/rvgtut.html +0 -530
- data/doc/rvguse.html +0 -145
- data/doc/rvgxform.html +0 -294
- data/doc/scripts/doc.js +0 -22
- data/doc/scripts/stripeTables.js +0 -23
- data/doc/struct.html +0 -1339
- data/doc/usage.html +0 -1621
- data/examples/constitute.rb +0 -7
- data/examples/crop_with_gravity.rb +0 -42
- data/examples/demo.rb +0 -324
- data/examples/describe.rb +0 -43
- data/examples/find_similar_region.rb +0 -34
- data/examples/histogram.rb +0 -321
- data/examples/identify.rb +0 -185
- data/examples/image_opacity.rb +0 -29
- data/examples/import_export.rb +0 -31
- data/examples/pattern_fill.rb +0 -38
- data/examples/rotating_text.rb +0 -44
- data/examples/spinner.rb +0 -49
- data/examples/thumbnail.rb +0 -64
- data/examples/vignette.rb +0 -78
- data/ext/RMagick/rmdraw.c +0 -2022
- data/ext/RMagick/rmenum.c +0 -1235
- data/ext/RMagick/rmilist.c +0 -1270
- data/ext/RMagick/rmimage.c +0 -15427
- data/ext/RMagick/rmmain.c +0 -1741
- data/ext/RMagick/rmmontage.c +0 -519
- data/ext/RMagick/rmpixel.c +0 -1114
- data/spec/rmagick/ImageList1_spec.rb +0 -24
- data/spec/rmagick/draw_spec.rb +0 -156
- data/spec/rmagick/image/blue_shift_spec.rb +0 -16
- data/spec/rmagick/image/composite_spec.rb +0 -140
- data/spec/rmagick/image/constitute_spec.rb +0 -15
- data/spec/rmagick/image/dispatch_spec.rb +0 -18
- data/spec/rmagick/image/from_blob_spec.rb +0 -14
- data/spec/rmagick/image/ping_spec.rb +0 -14
- data/spec/rmagick/image/properties_spec.rb +0 -29
- data/spec/spec_helper.rb +0 -4
- data/test/Image1.rb +0 -565
- data/test/Image2.rb +0 -1304
- data/test/Image3.rb +0 -1030
- data/test/ImageList1.rb +0 -806
- data/test/ImageList2.rb +0 -385
- data/test/Image_attributes.rb +0 -697
- data/test/Import_Export.rb +0 -121
- data/test/Info.rb +0 -345
- data/test/Magick.rb +0 -321
- data/test/Pixel.rb +0 -116
- data/test/Preview.rb +0 -57
- data/test/cmyk.icm +0 -0
- data/test/srgb.icm +0 -0
- data/test/test_all_basic.rb +0 -38
- data/test/tmpnam_test.rb +0 -50
- data/wercker.yml +0 -10
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é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 </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 </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 </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? 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 © 2002-2009 Timothy P. Hunter.</li>
|
403
|
-
|
404
|
-
<li>ImageMagick © 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
|
-
« <a href="index.html">Prev</a> | <a href=
|
412
|
-
"index.html">Contents</a> | <a href="usage.html">Next</a>
|
413
|
-
»
|
414
|
-
</div>
|
415
|
-
</body>
|
416
|
-
</html>
|