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.
- checksums.yaml +4 -4
- data/.codeclimate.yml +63 -0
- 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 +79 -0
- data/.gitignore +3 -1
- data/.rspec +1 -0
- data/.rubocop.yml +24 -0
- data/.rubocop_todo.yml +151 -297
- data/.yardopts +5 -0
- data/CHANGELOG.md +233 -0
- data/CODE_OF_CONDUCT.md +122 -7
- data/CONTRIBUTING.md +14 -10
- data/README.md +326 -0
- data/Rakefile +16 -22
- data/before_install_linux.sh +22 -28
- data/before_install_osx.sh +57 -2
- data/ext/RMagick/extconf.rb +149 -105
- data/ext/RMagick/rmagick.c +77 -104
- data/ext/RMagick/rmagick.h +121 -103
- data/ext/RMagick/rmdraw.c +364 -436
- data/ext/RMagick/rmenum.c +106 -114
- data/ext/RMagick/rmfill.c +149 -70
- data/ext/RMagick/rmilist.c +225 -367
- data/ext/RMagick/rmimage.c +4751 -4405
- data/ext/RMagick/rminfo.c +574 -787
- data/ext/RMagick/rmkinfo.c +51 -121
- data/ext/RMagick/rmmain.c +454 -286
- data/ext/RMagick/rmmontage.c +64 -130
- data/ext/RMagick/rmpixel.c +488 -437
- data/ext/RMagick/rmstruct.c +83 -96
- data/ext/RMagick/rmutil.c +302 -214
- data/lib/rmagick/version.rb +1 -1
- data/lib/rmagick_internal.rb +138 -93
- data/lib/rvg/clippath.rb +2 -1
- data/lib/rvg/container.rb +10 -5
- data/lib/rvg/describable.rb +1 -1
- data/lib/rvg/embellishable.rb +5 -4
- data/lib/rvg/misc.rb +15 -12
- data/lib/rvg/paint.rb +2 -1
- data/lib/rvg/pathdata.rb +12 -11
- data/lib/rvg/rvg.rb +12 -8
- data/lib/rvg/stylable.rb +9 -7
- data/lib/rvg/text.rb +11 -6
- data/lib/rvg/transformable.rb +3 -2
- data/lib/rvg/units.rb +1 -1
- data/rmagick.gemspec +10 -11
- metadata +52 -423
- data/.appveyor.yml +0 -45
- data/.circleci/config.yml +0 -56
- data/.ruby-version +0 -1
- data/.simplecov +0 -27
- data/.travis.yml +0 -62
- data/Doxyfile +0 -1514
- data/README.textile +0 -259
- data/benchmarks/memory/README.md +0 -50
- data/benchmarks/memory/image_new.rb +0 -8
- data/benchmarks/memory/rmagick.gnuplot +0 -16
- 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 -52
- 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 -41
- 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 -16
- 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 -45
- data/doc/ex/get_type_metrics.rb +0 -142
- data/doc/ex/gradientfill.rb +0 -27
- data/doc/ex/grav.rb +0 -45
- data/doc/ex/gravity.rb +0 -78
- 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.png +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.png +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.png +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 -37
- 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 -26
- 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 -126
- data/doc/ex/solarize.rb +0 -11
- data/doc/ex/sparse_color.rb +0 -55
- data/doc/ex/splice.rb +0 -8
- data/doc/ex/spread.rb +0 -11
- data/doc/ex/stegano.rb +0 -54
- 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 -570
- 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 -323
- data/examples/describe.rb +0 -41
- data/examples/find_similar_region.rb +0 -34
- data/examples/histogram.rb +0 -312
- data/examples/identify.rb +0 -174
- data/examples/image_opacity.rb +0 -28
- data/examples/import_export.rb +0 -31
- data/examples/pattern_fill.rb +0 -37
- data/examples/rotating_text.rb +0 -45
- data/examples/spinner.rb +0 -49
- data/examples/thumbnail.rb +0 -64
- data/examples/vignette.rb +0 -78
- data/lib/obsolete.rb +0 -66
- data/spec/rmagick/ImageList1_spec.rb +0 -24
- data/spec/rmagick/draw_spec.rb +0 -155
- data/spec/rmagick/image/blue_shift_spec.rb +0 -14
- data/spec/rmagick/image/channel_entropy_spec.rb +0 -9
- data/spec/rmagick/image/composite_spec.rb +0 -72
- data/spec/rmagick/image/constitute_spec.rb +0 -13
- data/spec/rmagick/image/dispatch_spec.rb +0 -16
- data/spec/rmagick/image/from_blob_spec.rb +0 -12
- data/spec/rmagick/image/ping_spec.rb +0 -12
- data/spec/rmagick/image/properties_spec.rb +0 -27
- data/spec/rmagick/image/read_spec.rb +0 -28
- data/spec/spec_helper.rb +0 -10
- data/spec/support/issue_200/app.rb +0 -8
- data/test/Draw.rb +0 -351
- data/test/Enum.rb +0 -228
- data/test/Fill.rb +0 -93
- data/test/Image1.rb +0 -627
- data/test/Image2.rb +0 -1426
- data/test/Image3.rb +0 -1091
- data/test/ImageList1.rb +0 -858
- data/test/ImageList2.rb +0 -406
- data/test/Image_attributes.rb +0 -666
- data/test/Import_Export.rb +0 -115
- data/test/Info.rb +0 -444
- data/test/KernelInfo.rb +0 -67
- data/test/Magick.rb +0 -311
- data/test/Pixel.rb +0 -285
- data/test/PolaroidOptions.rb +0 -23
- data/test/Preview.rb +0 -26
- data/test/Struct.rb +0 -45
- data/test/appearance/Montage.rb +0 -26
- data/test/appearance/appearance_assertion.rb +0 -13
- data/test/appearance/expected/montage_border_color.jpg +0 -0
- data/test/cmyk.icm +0 -0
- data/test/lib/Obsolete.rb +0 -30
- data/test/lib/internal/Draw.rb +0 -823
- data/test/lib/internal/Geometry.rb +0 -98
- data/test/lib/internal/Magick.rb +0 -40
- data/test/srgb.icm +0 -0
- data/test/test_all_basic.rb +0 -49
- 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é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>
|