rmagick-windows 2.16.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.editorconfig +14 -0
- data/.gitignore +23 -0
- data/.hound.yml +2 -0
- data/.rspec +1 -0
- data/.rubocop.yml +340 -0
- data/.simplecov +27 -0
- data/.travis.yml +60 -0
- data/CHANGELOG.md +915 -0
- data/CODE_OF_CONDUCT.md +13 -0
- data/CONTRIBUTING.md +50 -0
- data/Doxyfile +1514 -0
- data/Gemfile +10 -0
- data/LICENSE +20 -0
- data/README.textile +257 -0
- data/Rakefile +188 -0
- data/before_install_linux.sh +32 -0
- data/before_install_osx.sh +2 -0
- data/deprecated/RMagick.rb +6 -0
- data/doc/.cvsignore +1 -0
- data/doc/comtasks.html +287 -0
- data/doc/constants.html +1581 -0
- data/doc/css/doc.css +299 -0
- data/doc/css/popup.css +34 -0
- data/doc/css/ref.css +67 -0
- data/doc/draw.html +3272 -0
- data/doc/ex/InitialCoords.rb +22 -0
- data/doc/ex/NewCoordSys.rb +30 -0
- data/doc/ex/OrigCoordSys.rb +16 -0
- data/doc/ex/PreserveAspectRatio.rb +204 -0
- data/doc/ex/RotateScale.rb +36 -0
- data/doc/ex/Skew.rb +38 -0
- data/doc/ex/Use01.rb +15 -0
- data/doc/ex/Use02.rb +20 -0
- data/doc/ex/Use03.rb +16 -0
- data/doc/ex/ViewBox.rb +31 -0
- data/doc/ex/adaptive_threshold.rb +9 -0
- data/doc/ex/add_noise.rb +16 -0
- data/doc/ex/affine.rb +48 -0
- data/doc/ex/affine_transform.rb +20 -0
- data/doc/ex/arc.rb +49 -0
- data/doc/ex/arcpath.rb +32 -0
- data/doc/ex/arcs01.rb +28 -0
- data/doc/ex/arcs02.rb +59 -0
- data/doc/ex/average.rb +15 -0
- data/doc/ex/axes.rb +64 -0
- data/doc/ex/baseline_shift01.rb +17 -0
- data/doc/ex/bilevel_channel.rb +8 -0
- data/doc/ex/blur_image.rb +12 -0
- data/doc/ex/border.rb +10 -0
- data/doc/ex/bounding_box.rb +42 -0
- data/doc/ex/cbezier1.rb +41 -0
- data/doc/ex/cbezier2.rb +41 -0
- data/doc/ex/cbezier3.rb +41 -0
- data/doc/ex/cbezier4.rb +42 -0
- data/doc/ex/cbezier5.rb +42 -0
- data/doc/ex/cbezier6.rb +53 -0
- data/doc/ex/channel.rb +25 -0
- data/doc/ex/charcoal.rb +12 -0
- data/doc/ex/chop.rb +29 -0
- data/doc/ex/circle.rb +33 -0
- data/doc/ex/circle01.rb +16 -0
- data/doc/ex/clip_path.rb +60 -0
- data/doc/ex/coalesce.rb +57 -0
- data/doc/ex/color_fill_to_border.rb +29 -0
- data/doc/ex/color_floodfill.rb +28 -0
- data/doc/ex/color_histogram.rb +47 -0
- data/doc/ex/color_reset.rb +11 -0
- data/doc/ex/colorize.rb +16 -0
- data/doc/ex/colors.rb +64 -0
- data/doc/ex/compose_mask.rb +22 -0
- data/doc/ex/composite.rb +133 -0
- data/doc/ex/composite_layers.rb +53 -0
- data/doc/ex/composite_tiled.rb +21 -0
- data/doc/ex/contrast.rb +36 -0
- data/doc/ex/crop.rb +31 -0
- data/doc/ex/crop_with_gravity.rb +42 -0
- data/doc/ex/cubic01.rb +43 -0
- data/doc/ex/cubic02.rb +91 -0
- data/doc/ex/cycle_colormap.rb +21 -0
- data/doc/ex/dissolve.rb +12 -0
- data/doc/ex/drawcomp.rb +42 -0
- data/doc/ex/drop_shadow.rb +60 -0
- data/doc/ex/edge.rb +11 -0
- data/doc/ex/ellipse.rb +45 -0
- data/doc/ex/ellipse01.rb +21 -0
- data/doc/ex/emboss.rb +11 -0
- data/doc/ex/enhance.rb +28 -0
- data/doc/ex/equalize.rb +11 -0
- data/doc/ex/evenodd.rb +42 -0
- data/doc/ex/fill_pattern.rb +23 -0
- data/doc/ex/flatten_images.rb +36 -0
- data/doc/ex/flip.rb +11 -0
- data/doc/ex/flop.rb +11 -0
- data/doc/ex/font_styles.rb +32 -0
- data/doc/ex/fonts.rb +20 -0
- data/doc/ex/frame.rb +12 -0
- data/doc/ex/gaussian_blur.rb +11 -0
- data/doc/ex/get_multiline_type_metrics.rb +41 -0
- data/doc/ex/get_pixels.rb +47 -0
- data/doc/ex/get_type_metrics.rb +141 -0
- data/doc/ex/gradientfill.rb +27 -0
- data/doc/ex/grav.rb +45 -0
- data/doc/ex/gravity.rb +80 -0
- data/doc/ex/group.rb +26 -0
- data/doc/ex/hatchfill.rb +27 -0
- data/doc/ex/image.rb +44 -0
- 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 +34 -0
- data/doc/ex/level.rb +11 -0
- data/doc/ex/level_colors.rb +11 -0
- data/doc/ex/line.rb +41 -0
- data/doc/ex/line01.rb +21 -0
- data/doc/ex/mask.rb +35 -0
- data/doc/ex/matte_fill_to_border.rb +39 -0
- data/doc/ex/matte_floodfill.rb +32 -0
- data/doc/ex/matte_replace.rb +39 -0
- data/doc/ex/median_filter.rb +28 -0
- data/doc/ex/modulate.rb +11 -0
- data/doc/ex/mono.rb +23 -0
- data/doc/ex/morph.rb +25 -0
- data/doc/ex/mosaic.rb +35 -0
- data/doc/ex/motion_blur.rb +11 -0
- data/doc/ex/negate.rb +11 -0
- data/doc/ex/negate_channel.rb +9 -0
- data/doc/ex/nested_rvg.rb +21 -0
- data/doc/ex/nonzero.rb +42 -0
- data/doc/ex/normalize.rb +11 -0
- data/doc/ex/oil_paint.rb +11 -0
- data/doc/ex/opacity.rb +37 -0
- data/doc/ex/ordered_dither.rb +11 -0
- data/doc/ex/path.rb +63 -0
- data/doc/ex/pattern1.rb +25 -0
- data/doc/ex/pattern2.rb +26 -0
- data/doc/ex/polaroid.rb +27 -0
- data/doc/ex/polygon.rb +23 -0
- data/doc/ex/polygon01.rb +21 -0
- data/doc/ex/polyline.rb +22 -0
- data/doc/ex/polyline01.rb +21 -0
- data/doc/ex/posterize.rb +8 -0
- data/doc/ex/preview.rb +8 -0
- data/doc/ex/qbezierpath.rb +52 -0
- data/doc/ex/quad01.rb +34 -0
- data/doc/ex/quantize-m.rb +25 -0
- data/doc/ex/radial_blur.rb +9 -0
- data/doc/ex/raise.rb +8 -0
- data/doc/ex/random_threshold_channel.rb +13 -0
- data/doc/ex/rect01.rb +14 -0
- data/doc/ex/rect02.rb +20 -0
- data/doc/ex/rectangle.rb +34 -0
- data/doc/ex/reduce_noise.rb +28 -0
- data/doc/ex/remap.rb +11 -0
- data/doc/ex/remap_images.rb +19 -0
- data/doc/ex/resize_to_fill.rb +8 -0
- data/doc/ex/resize_to_fit.rb +8 -0
- data/doc/ex/roll.rb +9 -0
- data/doc/ex/rotate.rb +44 -0
- data/doc/ex/rotate_f.rb +14 -0
- data/doc/ex/roundrect.rb +33 -0
- data/doc/ex/rubyname.rb +30 -0
- data/doc/ex/rvg_clippath.rb +12 -0
- data/doc/ex/rvg_linecap.rb +42 -0
- data/doc/ex/rvg_linejoin.rb +40 -0
- data/doc/ex/rvg_opacity.rb +18 -0
- data/doc/ex/rvg_pattern.rb +26 -0
- data/doc/ex/rvg_stroke_dasharray.rb +11 -0
- data/doc/ex/segment.rb +11 -0
- data/doc/ex/sepiatone.rb +7 -0
- data/doc/ex/shade.rb +11 -0
- data/doc/ex/shadow.rb +30 -0
- data/doc/ex/shave.rb +15 -0
- data/doc/ex/shear.rb +10 -0
- data/doc/ex/sketch.rb +17 -0
- data/doc/ex/skewx.rb +51 -0
- data/doc/ex/skewy.rb +47 -0
- data/doc/ex/smile.rb +125 -0
- data/doc/ex/solarize.rb +11 -0
- data/doc/ex/sparse_color.rb +54 -0
- data/doc/ex/splice.rb +8 -0
- data/doc/ex/spread.rb +11 -0
- data/doc/ex/stegano.rb +55 -0
- data/doc/ex/stroke_dasharray.rb +42 -0
- data/doc/ex/stroke_fill.rb +10 -0
- data/doc/ex/stroke_linecap.rb +44 -0
- data/doc/ex/stroke_linejoin.rb +48 -0
- data/doc/ex/stroke_width.rb +49 -0
- data/doc/ex/swirl.rb +17 -0
- data/doc/ex/text.rb +37 -0
- data/doc/ex/text01.rb +16 -0
- data/doc/ex/text_align.rb +36 -0
- data/doc/ex/text_antialias.rb +37 -0
- data/doc/ex/text_styles.rb +19 -0
- data/doc/ex/text_undercolor.rb +28 -0
- data/doc/ex/texture_fill_to_border.rb +34 -0
- data/doc/ex/texture_floodfill.rb +32 -0
- data/doc/ex/texturefill.rb +24 -0
- data/doc/ex/threshold.rb +13 -0
- data/doc/ex/to_blob.rb +13 -0
- data/doc/ex/translate.rb +39 -0
- data/doc/ex/transparent.rb +38 -0
- data/doc/ex/transpose.rb +9 -0
- data/doc/ex/transverse.rb +9 -0
- data/doc/ex/tref01.rb +24 -0
- data/doc/ex/triangle01.rb +15 -0
- data/doc/ex/trim.rb +23 -0
- data/doc/ex/tspan01.rb +17 -0
- data/doc/ex/tspan02.rb +17 -0
- data/doc/ex/tspan03.rb +19 -0
- data/doc/ex/unsharp_mask.rb +28 -0
- data/doc/ex/viewex.rb +33 -0
- data/doc/ex/vignette.rb +12 -0
- data/doc/ex/watermark.rb +27 -0
- data/doc/ex/wave.rb +9 -0
- data/doc/ex/wet_floor.rb +58 -0
- data/doc/ex/writing_mode01.rb +26 -0
- data/doc/ex/writing_mode02.rb +26 -0
- data/doc/ilist.html +2056 -0
- data/doc/image1.html +4680 -0
- data/doc/image2.html +3665 -0
- data/doc/image3.html +4522 -0
- data/doc/imageattrs.html +1638 -0
- data/doc/imusage.html +514 -0
- data/doc/index.html +416 -0
- data/doc/info.html +1499 -0
- data/doc/magick.html +565 -0
- data/doc/optequiv.html +2435 -0
- data/doc/rvg.html +975 -0
- data/doc/rvgclip.html +248 -0
- data/doc/rvggroup.html +305 -0
- data/doc/rvgimage.html +289 -0
- data/doc/rvgpattern.html +475 -0
- data/doc/rvgshape.html +406 -0
- data/doc/rvgstyle.html +270 -0
- data/doc/rvgtext.html +465 -0
- data/doc/rvgtspan.html +238 -0
- data/doc/rvgtut.html +530 -0
- data/doc/rvguse.html +145 -0
- data/doc/rvgxform.html +294 -0
- data/doc/scripts/doc.js +22 -0
- data/doc/scripts/stripeTables.js +23 -0
- data/doc/struct.html +1339 -0
- data/doc/usage.html +1621 -0
- data/examples/constitute.rb +7 -0
- data/examples/crop_with_gravity.rb +42 -0
- data/examples/demo.rb +324 -0
- data/examples/describe.rb +43 -0
- data/examples/find_similar_region.rb +34 -0
- data/examples/histogram.rb +321 -0
- data/examples/identify.rb +185 -0
- data/examples/image_opacity.rb +29 -0
- data/examples/import_export.rb +31 -0
- data/examples/pattern_fill.rb +38 -0
- data/examples/rotating_text.rb +44 -0
- data/examples/spinner.rb +49 -0
- data/examples/thumbnail.rb +64 -0
- data/examples/vignette.rb +78 -0
- data/ext/RMagick/extconf.rb +548 -0
- data/ext/RMagick/rmagick.c +401 -0
- data/ext/RMagick/rmagick.h +1287 -0
- data/ext/RMagick/rmdraw.c +2022 -0
- data/ext/RMagick/rmenum.c +1235 -0
- data/ext/RMagick/rmfill.c +720 -0
- data/ext/RMagick/rmilist.c +1270 -0
- data/ext/RMagick/rmimage.c +15427 -0
- data/ext/RMagick/rminfo.c +2590 -0
- data/ext/RMagick/rmmain.c +1741 -0
- data/ext/RMagick/rmmontage.c +519 -0
- data/ext/RMagick/rmpixel.c +1114 -0
- data/ext/RMagick/rmstruct.c +1124 -0
- data/ext/RMagick/rmutil.c +1754 -0
- data/lib/rmagick.rb +1 -0
- data/lib/rmagick/version.rb +6 -0
- data/lib/rmagick_internal.rb +1947 -0
- data/lib/rvg/clippath.rb +45 -0
- data/lib/rvg/container.rb +122 -0
- data/lib/rvg/deep_equal.rb +52 -0
- data/lib/rvg/describable.rb +47 -0
- data/lib/rvg/embellishable.rb +391 -0
- data/lib/rvg/misc.rb +723 -0
- data/lib/rvg/paint.rb +50 -0
- data/lib/rvg/pathdata.rb +126 -0
- data/lib/rvg/rvg.rb +283 -0
- data/lib/rvg/stretchable.rb +165 -0
- data/lib/rvg/stylable.rb +116 -0
- data/lib/rvg/text.rb +172 -0
- data/lib/rvg/transformable.rb +126 -0
- data/lib/rvg/units.rb +63 -0
- data/rmagick.gemspec +46 -0
- data/spec/rmagick/ImageList1_spec.rb +24 -0
- data/spec/rmagick/draw_spec.rb +156 -0
- data/spec/rmagick/image/blue_shift_spec.rb +16 -0
- data/spec/rmagick/image/composite_spec.rb +140 -0
- data/spec/rmagick/image/constitute_spec.rb +15 -0
- data/spec/rmagick/image/dispatch_spec.rb +18 -0
- data/spec/rmagick/image/from_blob_spec.rb +14 -0
- data/spec/rmagick/image/ping_spec.rb +14 -0
- data/spec/rmagick/image/properties_spec.rb +29 -0
- data/spec/spec_helper.rb +4 -0
- data/test/Image1.rb +565 -0
- data/test/Image2.rb +1304 -0
- data/test/Image3.rb +1030 -0
- data/test/ImageList1.rb +806 -0
- data/test/ImageList2.rb +385 -0
- data/test/Image_attributes.rb +697 -0
- data/test/Import_Export.rb +121 -0
- data/test/Info.rb +345 -0
- data/test/Magick.rb +321 -0
- data/test/Pixel.rb +116 -0
- data/test/Preview.rb +57 -0
- data/test/cmyk.icm +0 -0
- data/test/srgb.icm +0 -0
- data/test/test_all_basic.rb +38 -0
- data/test/tmpnam_test.rb +50 -0
- data/wercker.yml +10 -0
- metadata +509 -0
data/Gemfile
ADDED
data/LICENSE
ADDED
@@ -0,0 +1,20 @@
|
|
1
|
+
Copyright © 2002-2013 Timothy P. Hunter
|
2
|
+
|
3
|
+
Permission is hereby granted, free of charge, to any person obtaining
|
4
|
+
a copy of this software and associated documentation files (the
|
5
|
+
"Software"), to deal in the Software without restriction, including
|
6
|
+
without limitation the rights to use, copy, modify, merge, publish,
|
7
|
+
distribute, sublicense, and/or sell copies of the Software, and to
|
8
|
+
permit persons to whom the Software is furnished to do so, subject to
|
9
|
+
the following conditions:
|
10
|
+
|
11
|
+
The above copyright notice and this permission notice shall be
|
12
|
+
included in all copies or substantial portions of the Software.
|
13
|
+
|
14
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
15
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
16
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
17
|
+
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
18
|
+
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
19
|
+
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
20
|
+
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
data/README.textile
ADDED
@@ -0,0 +1,257 @@
|
|
1
|
+
h1. RMagick
|
2
|
+
|
3
|
+
!https://img.shields.io/gem/v/rmagick.svg?style=flat(RubyGems)!:http://rubygems.org/gems/rmagick !https://img.shields.io/gem/dt/rmagick.svg?style=flat! !https://www.versioneye.com/ruby/rmagick/reference_badge.svg?style=flat(VersionEye)!:https://www.versioneye.com/ruby/rmagick/references !https://img.shields.io/travis/rmagick/rmagick/master.svg?style=flat(Travis CI)!:https://travis-ci.org/rmagick/rmagick !https://img.shields.io/codeclimate/github/rmagick/rmagick.svg?style=flat(Code Climate)!:https://codeclimate.com/github/rmagick/rmagick !https://badges.gitter.im/Join%20Chat.svg(Gitter)!:https://gitter.im/rmagick/rmagick?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
|
4
|
+
|
5
|
+
h3. Table of Contents
|
6
|
+
|
7
|
+
* "Introduction":#intro
|
8
|
+
* "Prerequisites":#prereq
|
9
|
+
* "Installing RMagick":#install
|
10
|
+
* "Things that can go wrong":#wrong
|
11
|
+
* "Upgrading":#upgrade
|
12
|
+
* "More samples":#samples
|
13
|
+
* "Reporting Bugs":#bugs
|
14
|
+
* "Development Setup":#dev-setup
|
15
|
+
* "Contact Information":#contact
|
16
|
+
* "Credits":#credits
|
17
|
+
* "License":#license
|
18
|
+
* "Releasing":#releasing
|
19
|
+
|
20
|
+
h2(#intro). Introduction
|
21
|
+
|
22
|
+
RMagick is an interface between the Ruby programming language and the
|
23
|
+
ImageMagick image processing library.
|
24
|
+
|
25
|
+
h2(#prereq). Prerequisites
|
26
|
+
|
27
|
+
*O/S* Linux, *BSD, OS X, Windows 2000, XP, Vista, other *nix-like systems.
|
28
|
+
|
29
|
+
*Ruby* Version 2.0.0 or later. You can get Ruby from "www.ruby-lang.org":http://www.ruby-lang.org.
|
30
|
+
|
31
|
+
Ruby must be able to build C-Extensions (e.g. MRI, Rubinius, not JRuby)
|
32
|
+
|
33
|
+
*ImageMagick* Version 6.4.9 or later. You can get ImageMagick from "www.imagemagick.org":http://www.imagemagick.org.
|
34
|
+
|
35
|
+
On Ubuntu, you can run:
|
36
|
+
|
37
|
+
bc. sudo apt-get install libmagickwand-dev
|
38
|
+
|
39
|
+
On Centos, you can run:
|
40
|
+
|
41
|
+
bc. sudo yum install gcc ImageMagick-devel make which
|
42
|
+
|
43
|
+
*Note to Windows users:* Please make sure that you choose an ImageMagick version that matches the bitness of your Ruby version.
|
44
|
+
|
45
|
+
h2(#install). Installing RMagick
|
46
|
+
|
47
|
+
h4. Installing via Bundler
|
48
|
+
|
49
|
+
Add to your `Gemfile`:
|
50
|
+
|
51
|
+
bc. gem 'rmagick'
|
52
|
+
|
53
|
+
Then run:
|
54
|
+
|
55
|
+
bc. bundle install
|
56
|
+
|
57
|
+
h4. Installing via RubyGems
|
58
|
+
|
59
|
+
Run:
|
60
|
+
|
61
|
+
bc. gem install rmagick
|
62
|
+
|
63
|
+
h4. Versioning
|
64
|
+
|
65
|
+
RMagick is versioned according to Semantic Versioning.
|
66
|
+
For stable version compatible with Ruby 1.8+, use `~> 2.0`.
|
67
|
+
Upcoming version 3 will work on Ruby 2.x only.
|
68
|
+
|
69
|
+
h2(#usage). Using RMagick
|
70
|
+
|
71
|
+
Require RMagick in your project as follows:
|
72
|
+
|
73
|
+
bc. require 'rmagick'
|
74
|
+
|
75
|
+
See https://rmagick.github.io/usage.html for links to more information.
|
76
|
+
|
77
|
+
h2(#wrong). Things that can go wrong
|
78
|
+
|
79
|
+
The "RMagick installation FAQ":https://web.archive.org/web/20140512193354/http://rmagick.rubyforge.org/install-faq.html
|
80
|
+
has answers to the most commonly reported problems, though may be out of date.
|
81
|
+
|
82
|
+
h4. Can't install RMagick. Can't find libMagick or one of the dependent libraries. Check the mkmf.log file for more detailed information.
|
83
|
+
|
84
|
+
Typically this message means that one or more of the libraries that ImageMagick
|
85
|
+
depends on hasn't been installed. Examine the mkmf.log file in the ext/RMagick
|
86
|
+
subdirectory of the installation directory for any error messages. These messages
|
87
|
+
typically contain enough additional information for you to be able to diagnose
|
88
|
+
the problem. Also see "this FAQ":https://web.archive.org/web/20140512193354/http://rmagick.rubyforge.org/install-faq.html#libmagick.
|
89
|
+
|
90
|
+
On OS X with Homebrew, try [re]installing pkg-config:
|
91
|
+
|
92
|
+
<pre>
|
93
|
+
brew uninstall pkg-config
|
94
|
+
brew install pkg-config
|
95
|
+
brew unlink pkg-config
|
96
|
+
brew link pkg-config
|
97
|
+
</pre>
|
98
|
+
|
99
|
+
h4. Cannot open shared object file
|
100
|
+
|
101
|
+
If you get a message like this:
|
102
|
+
|
103
|
+
<pre>
|
104
|
+
$DIR/RMagick.rb:11:in `require': libMagick.so.0:
|
105
|
+
cannot open shared object file: No such file or directory -
|
106
|
+
$DIR/RMagick2.so (LoadError)
|
107
|
+
</pre>
|
108
|
+
|
109
|
+
you probably do not have the directory in which the ImageMagick library
|
110
|
+
is installed in your load path. An easy way to fix this is to define
|
111
|
+
the directory in the LD_LIBRARY_PATH environment variable. For
|
112
|
+
example, suppose you installed the ImageMagick library libMagick.so in
|
113
|
+
/usr/local/lib. (By default this is where it is installed.) Create the
|
114
|
+
LD_LIBRARY_PATH variable like this:
|
115
|
+
|
116
|
+
<pre>
|
117
|
+
export LD_LIBRARY_PATH=/usr/local/lib
|
118
|
+
</pre>
|
119
|
+
|
120
|
+
On Linux, see @ld(1)@ and @ld.so(8)@ for more information. On other operating
|
121
|
+
systems, see the documentation for the dynamic loading facility.
|
122
|
+
|
123
|
+
h4. Segmentation fault
|
124
|
+
|
125
|
+
Default stack size of your operating system might be too small. Try removing the limit with this command:
|
126
|
+
|
127
|
+
<pre>
|
128
|
+
ulimit -s unlimited
|
129
|
+
</pre>
|
130
|
+
|
131
|
+
h2(#upgrade). Upgrading
|
132
|
+
|
133
|
+
If you upgrade to a newer release of ImageMagick, make sure you're using a
|
134
|
+
release of RMagick that supports that release. It's safe to install a new
|
135
|
+
release of RMagick over an earlier release.
|
136
|
+
|
137
|
+
h2(#samples). More samples
|
138
|
+
|
139
|
+
You can find more sample RMagick programs in the /example directory.
|
140
|
+
These programs are not installed in the RMagick documentation tree.
|
141
|
+
|
142
|
+
h2(#bugs). Reporting bugs
|
143
|
+
|
144
|
+
Please report bugs in RMagick, its documentation, or its installation
|
145
|
+
programs to me via the bug tracker on the "RMagick issues page":https://github.com/rmagick/rmagick/issues
|
146
|
+
|
147
|
+
However, I can't help with Ruby installation and configuration or ImageMagick
|
148
|
+
installation and configuration. Information about reporting problems and
|
149
|
+
getting help for ImageMagick is available at the "ImageMagick web site":http://www.imagemagick.org
|
150
|
+
or the "ImageMagick Forum":http://www.imagemagick.org/discourse-server.
|
151
|
+
|
152
|
+
h2(#dev-setup). Development Setup
|
153
|
+
|
154
|
+
In order to minimize issues on your local machine, we recommend that you make
|
155
|
+
use of a "Vagrant installation":https://github.com/tjschuck/rake-compiler-dev-box.
|
156
|
+
|
157
|
+
Steps to get up and running with a passing build are as follows:
|
158
|
+
|
159
|
+
h4. 1) set up the Vagrant environment
|
160
|
+
|
161
|
+
If you don't already have Vagrant installed, you can download and install it
|
162
|
+
from "here":https://www.vagrantup.com/. Once installed, we can set up a pre-built environment:
|
163
|
+
|
164
|
+
<pre>
|
165
|
+
git clone https://github.com/tjschuck/rake-compiler-dev-box.git
|
166
|
+
cd rake-compiler-dev-box
|
167
|
+
vagrant up
|
168
|
+
</pre>
|
169
|
+
|
170
|
+
This last part will probably take a while as it has to download an Ubuntu image
|
171
|
+
and configure it. If there is an error during this process, you may need to
|
172
|
+
reboot your computer and enable virtualization in your BIOS settings.
|
173
|
+
|
174
|
+
h4. 2) clone RMagick and log in to the vagrant box
|
175
|
+
|
176
|
+
Within the `rake-compiler-dev-box` directory:
|
177
|
+
|
178
|
+
<pre>
|
179
|
+
git clone https://github.com/rmagick/rmagick.git # or your fork
|
180
|
+
vagrant ssh
|
181
|
+
</pre>
|
182
|
+
|
183
|
+
h4. 3) install ImageMagick and additional environment stuff
|
184
|
+
|
185
|
+
<pre>
|
186
|
+
cd /vagrant/rmagick
|
187
|
+
export IMAGEMAGICK_VERSION=6.6.9-10 # the only known passing version as of this writing
|
188
|
+
sh ./before_install_linux.sh
|
189
|
+
</pre>
|
190
|
+
|
191
|
+
This will take just a few minutes to build ImageMagick
|
192
|
+
|
193
|
+
h4. 4) build RMagick
|
194
|
+
|
195
|
+
<pre>
|
196
|
+
rake
|
197
|
+
</pre>
|
198
|
+
|
199
|
+
This compiles the RMagick extensions and runs the tests. If all goes well
|
200
|
+
you'll see a lot of output, eventually ending in something like:
|
201
|
+
|
202
|
+
<pre>
|
203
|
+
Finished tests in 35.865734s, 11.3758 tests/s, 6560.3007 assertions/s.
|
204
|
+
|
205
|
+
408 tests, 235290 assertions, 0 failures, 0 errors, 0 skips
|
206
|
+
</pre>
|
207
|
+
|
208
|
+
And you're all set! The copy of RMagick within `/vagrant/rmagick` inside your
|
209
|
+
Vagrant session is the same as the one in the `rake-compiler-dev-box` directory
|
210
|
+
on your machine. You can make changes locally and run tests within your `ssh`
|
211
|
+
session.
|
212
|
+
|
213
|
+
h2(#contact). Contact Information
|
214
|
+
|
215
|
+
*Author:* Tim Hunter, Omer Bar-or, Benjamin Thomas
|
216
|
+
|
217
|
+
h2(#credits). Credits
|
218
|
+
|
219
|
+
Thanks to "ImageMagick Studio LLC":http://www.imagemagick.org for ImageMagick
|
220
|
+
and for hosting the RMagick documentation.
|
221
|
+
|
222
|
+
h2(#license). MIT License
|
223
|
+
|
224
|
+
<pre>
|
225
|
+
Copyright © 2002-2009 by Timothy P. Hunter
|
226
|
+
|
227
|
+
Changes since Nov. 2009 copyright © by Benjamin Thomas and Omer Bar-or
|
228
|
+
|
229
|
+
Permission is hereby granted, free of charge, to any person obtaining a
|
230
|
+
copy of this software and associated documentation files (the "Software"),
|
231
|
+
to deal in the Software without restriction, including without limitation
|
232
|
+
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
233
|
+
and/or sell copies of the Software, and to permit persons to whom the
|
234
|
+
Software is furnished to do so, subject to the following conditions:
|
235
|
+
|
236
|
+
The above copyright notice and this permission notice shall be included in
|
237
|
+
all copies or substantial portions of the Software.
|
238
|
+
|
239
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
240
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
241
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
242
|
+
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
243
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
244
|
+
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
245
|
+
DEALINGS IN THE SOFTWARE.
|
246
|
+
</pre>
|
247
|
+
|
248
|
+
<hr>
|
249
|
+
|
250
|
+
h2(#releasing). Releasing
|
251
|
+
|
252
|
+
See https://github.com/rmagick/rmagick/wiki/Release-Process
|
253
|
+
|
254
|
+
# Update ChangeLog
|
255
|
+
# Edit lib/rmagick/version.rb
|
256
|
+
# Are the tests passing? Run `rake` again just to be sure.
|
257
|
+
# `rake release`
|
data/Rakefile
ADDED
@@ -0,0 +1,188 @@
|
|
1
|
+
require 'simplecov'
|
2
|
+
require './lib/rmagick/version'
|
3
|
+
require 'fileutils'
|
4
|
+
require 'English'
|
5
|
+
|
6
|
+
task :config do
|
7
|
+
def version
|
8
|
+
Magick::VERSION
|
9
|
+
end
|
10
|
+
# e.g. 2.13.3 becomes RMagick_2-13-3
|
11
|
+
def version_tag
|
12
|
+
"RMagick_#{version.gsub('.','-')}"
|
13
|
+
end
|
14
|
+
# e.g. 2.13.3 becomes rmagick-2.13.3.gem
|
15
|
+
def gem_name
|
16
|
+
"rmagick-#{version}.gem"
|
17
|
+
end
|
18
|
+
|
19
|
+
def base
|
20
|
+
File.expand_path('..', __FILE__)
|
21
|
+
end
|
22
|
+
end
|
23
|
+
|
24
|
+
desc 'abort when repo is not clean or has uncommited code'
|
25
|
+
task :assert_clean_repo do
|
26
|
+
sh('git diff --exit-code')
|
27
|
+
abort 'Git repo not clean' unless $CHILD_STATUS.success?
|
28
|
+
sh('git diff-index --quiet --cached HEAD')
|
29
|
+
abort 'Git repo not commited' unless $CHILD_STATUS.success?
|
30
|
+
end
|
31
|
+
|
32
|
+
desc 'build gem'
|
33
|
+
task :build => [:config] do
|
34
|
+
sh 'gem build -V rmagick.gemspec'
|
35
|
+
if $CHILD_STATUS.success?
|
36
|
+
FileUtils.mkdir_p(File.join(base, 'pkg'))
|
37
|
+
FileUtils.mv(File.join(base, gem_name), 'pkg')
|
38
|
+
else
|
39
|
+
STDERR.puts 'Could not build gem'
|
40
|
+
exit $CHILD_STATUS.exitstatus
|
41
|
+
end
|
42
|
+
end
|
43
|
+
|
44
|
+
task :push_and_tag => [:build] do
|
45
|
+
sh "gem push #{File.join(base, 'pkg', gem_name)}"
|
46
|
+
if $CHILD_STATUS.success?
|
47
|
+
sh "git tag -a -m \"Version #{version}\" #{version_tag}"
|
48
|
+
STDOUT.puts "Tagged #{version_tag}."
|
49
|
+
sh 'git push'
|
50
|
+
sh 'git push --tags'
|
51
|
+
else
|
52
|
+
abort 'tagging aborted pushing gem failed'
|
53
|
+
end
|
54
|
+
end
|
55
|
+
|
56
|
+
desc 'Release'
|
57
|
+
task :release => [:assert_clean_repo, :push_and_tag]
|
58
|
+
|
59
|
+
desc 'Release and build the legacy way'
|
60
|
+
task :legacy_release=> ['legacy:README.html', 'legacy:extconf', 'legacy:doc', 'legacy:manifest', 'release']
|
61
|
+
|
62
|
+
namespace :legacy do
|
63
|
+
require 'find'
|
64
|
+
|
65
|
+
task :redcloth do
|
66
|
+
require 'redcloth'
|
67
|
+
end
|
68
|
+
|
69
|
+
README = 'README.html'
|
70
|
+
MANIFEST = 'ext/RMagick/MANIFEST'
|
71
|
+
|
72
|
+
# Change the version number placeholders in a file.
|
73
|
+
# Returns an array of lines from the file.
|
74
|
+
def reversion(name)
|
75
|
+
now = Time.new
|
76
|
+
now = now.strftime('%m/%d/%y')
|
77
|
+
|
78
|
+
lines = File.readlines name
|
79
|
+
lines.each do |line|
|
80
|
+
line.gsub!(%r{0\.0\.0}, Magick::VERSION)
|
81
|
+
line.gsub!(%r{YY/MM/DD}, now)
|
82
|
+
end
|
83
|
+
lines
|
84
|
+
end
|
85
|
+
|
86
|
+
# Rewrite a file containing embedded version number placeholders.
|
87
|
+
def reversion_file(name)
|
88
|
+
lines = reversion(name)
|
89
|
+
tmp_name = name + '_tmp'
|
90
|
+
mv name, tmp_name
|
91
|
+
begin
|
92
|
+
File.open(name, 'w') { |f| lines.each { |line| f.write line } }
|
93
|
+
rescue
|
94
|
+
mv tmp_name, name
|
95
|
+
ensure
|
96
|
+
rm tmp_name
|
97
|
+
end
|
98
|
+
end
|
99
|
+
|
100
|
+
desc 'Update version in extconf'
|
101
|
+
task :extconf do
|
102
|
+
reversion_file 'ext/RMagick/extconf.rb'
|
103
|
+
end
|
104
|
+
|
105
|
+
desc 'Build README.txt from README.textile using RedCloth'
|
106
|
+
task 'README.txt' => [:redcloth] do
|
107
|
+
reversion_file 'README.textile'
|
108
|
+
body = File.readlines 'README.textile'
|
109
|
+
body = RedCloth.new(body.join).to_html + "\n"
|
110
|
+
File.open('README.txt', 'w') { |f| f.write body }
|
111
|
+
end
|
112
|
+
|
113
|
+
desc 'Build README.html from README.txt'
|
114
|
+
task README => 'README.txt' do
|
115
|
+
puts "writing #{README}"
|
116
|
+
File.open(README, 'w') do |html|
|
117
|
+
html.write <<END_HTML_HEAD
|
118
|
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
119
|
+
<html>
|
120
|
+
<head>
|
121
|
+
<title>RMagick #{Magick::VERSION} README</title>
|
122
|
+
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
123
|
+
<meta name="GENERATOR" content="RedCloth">
|
124
|
+
</head>
|
125
|
+
<body>
|
126
|
+
END_HTML_HEAD
|
127
|
+
html.write File.readlines('README.txt')
|
128
|
+
html.write <<END_HTML_TAIL
|
129
|
+
</body>
|
130
|
+
</html>
|
131
|
+
END_HTML_TAIL
|
132
|
+
end
|
133
|
+
end
|
134
|
+
|
135
|
+
desc 'Update versions in html files'
|
136
|
+
task :doc do
|
137
|
+
Dir.chdir('doc') do
|
138
|
+
FileList['*.html'].each { |d| reversion_file(d) }
|
139
|
+
end
|
140
|
+
end
|
141
|
+
|
142
|
+
# Remove files we don't want in the tarball.
|
143
|
+
# Ensure files are not executable. (ref: bug #10080)
|
144
|
+
desc "Remove files we don't want in the .gem; ensure files are not executable"
|
145
|
+
task :fix_files do
|
146
|
+
rm 'README.txt', :verbose => true
|
147
|
+
chmod 0644, FileList['doc/*.html', 'doc/ex/*.rb', 'doc/ex/images/*', 'examples/*.rb']
|
148
|
+
end
|
149
|
+
|
150
|
+
desc 'Build manifest'
|
151
|
+
task :manifest do
|
152
|
+
now = Time.new
|
153
|
+
now = now.strftime('%H:%M:%S %m/%d/%y')
|
154
|
+
puts "generating #{MANIFEST}"
|
155
|
+
|
156
|
+
File.open(MANIFEST, 'w') do |f|
|
157
|
+
f.puts "MANIFEST for #{Magick::VERSION} - #{now}\n\n"
|
158
|
+
Find.find('.') do |name|
|
159
|
+
next if File.directory? name
|
160
|
+
f.puts name[2..-1] # remove leading "./"
|
161
|
+
end
|
162
|
+
end
|
163
|
+
end
|
164
|
+
end
|
165
|
+
|
166
|
+
require 'rake/extensiontask'
|
167
|
+
require 'rake/testtask'
|
168
|
+
require 'rspec/core/rake_task'
|
169
|
+
RSpec::Core::RakeTask.new(:spec)
|
170
|
+
|
171
|
+
Rake::ExtensionTask.new('RMagick2') do |ext|
|
172
|
+
ext.ext_dir = 'ext/RMagick'
|
173
|
+
end
|
174
|
+
|
175
|
+
Rake::TestTask.new(:test) do |t|
|
176
|
+
t.libs << 'test'
|
177
|
+
end
|
178
|
+
|
179
|
+
task :test => :compile
|
180
|
+
task :spec => :compile
|
181
|
+
|
182
|
+
if ENV['STYLE_CHECKS']
|
183
|
+
require 'rubocop/rake_task'
|
184
|
+
RuboCop::RakeTask.new
|
185
|
+
task :default => [:spec, :test, :rubocop]
|
186
|
+
else
|
187
|
+
task :default => [:spec, :test]
|
188
|
+
end
|