rmagick 1.15.17 → 2.0.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.
- data/ChangeLog +78 -25
- data/README.html +117 -188
- data/README.txt +116 -181
- data/build_tarball.rake +205 -0
- data/doc/comtasks.html +2 -2
- data/doc/constants.html +118 -44
- data/doc/draw.html +57 -99
- data/doc/ex/adaptive_threshold.rb +1 -10
- data/doc/ex/add_noise.rb +4 -5
- data/doc/ex/axes.rb +1 -1
- data/doc/ex/bilevel_channel.rb +2 -13
- data/doc/ex/bounding_box.rb +3 -4
- data/doc/ex/channel.rb +6 -7
- data/doc/ex/clip_path.rb +11 -5
- data/doc/ex/color_histogram.rb +8 -20
- data/doc/ex/composite_layers.rb +53 -0
- data/doc/ex/fill_pattern.rb +26 -0
- data/doc/ex/get_multiline_type_metrics.rb +26 -37
- data/doc/ex/get_type_metrics.rb +25 -25
- data/doc/ex/images/notimplemented.gif +0 -0
- data/doc/ex/level.rb +1 -1
- data/doc/ex/matte_floodfill.rb +5 -6
- data/doc/ex/matte_replace.rb +5 -6
- data/doc/ex/negate_channel.rb +0 -10
- data/doc/ex/opacity.rb +3 -5
- data/doc/ex/polaroid.rb +4 -1
- data/doc/ex/posterize.rb +1 -12
- data/doc/ex/preview.rb +1 -8
- data/doc/ex/radial_blur.rb +1 -11
- data/doc/ex/raise.rb +1 -4
- data/doc/ex/random_threshold_channel.rb +4 -9
- data/doc/ex/sepiatone.rb +2 -9
- data/doc/ex/shadow.rb +12 -18
- data/doc/ex/sketch.rb +2 -9
- data/doc/ex/smile.rb +7 -7
- data/doc/ex/splice.rb +3 -10
- data/doc/ex/stegano.rb +5 -0
- data/doc/ex/threshold.rb +2 -2
- data/doc/ex/transpose.rb +1 -8
- data/doc/ex/transverse.rb +1 -8
- data/doc/ex/trim.rb +1 -2
- data/doc/ex/viewex.rb +4 -5
- data/doc/ex/vignette.rb +1 -8
- data/doc/ex/watermark.rb +1 -0
- data/doc/ex/wet_floor.rb +8 -14
- data/doc/ilist.html +301 -110
- data/doc/image1.html +362 -258
- data/doc/image2.html +429 -286
- data/doc/image3.html +418 -192
- data/doc/imageattrs.html +100 -39
- data/doc/imusage.html +26 -21
- data/doc/index.html +52 -93
- data/doc/info.html +160 -64
- data/doc/magick.html +37 -71
- data/doc/optequiv.html +155 -61
- data/doc/rvg.html +3 -3
- data/doc/rvgclip.html +2 -2
- data/doc/rvggroup.html +2 -2
- data/doc/rvgimage.html +3 -3
- data/doc/rvgpattern.html +3 -3
- data/doc/rvgshape.html +2 -2
- data/doc/rvgstyle.html +2 -2
- data/doc/rvgtext.html +2 -2
- data/doc/rvgtspan.html +4 -4
- data/doc/rvgtut.html +4 -4
- data/doc/rvguse.html +3 -3
- data/doc/rvgxform.html +2 -2
- data/doc/struct.html +26 -29
- data/doc/usage.html +99 -48
- data/examples/crop_with_gravity.rb +46 -0
- data/examples/demo.rb +2 -2
- data/examples/histogram.rb +11 -11
- data/examples/identify.rb +45 -45
- data/examples/spinner.rb +3 -2
- data/ext/RMagick/MANIFEST +7 -8
- data/ext/RMagick/extconf.rb +242 -0
- data/ext/RMagick/rmagick.h +136 -222
- data/ext/RMagick/rmdraw.c +226 -229
- data/ext/RMagick/rmfill.c +69 -118
- data/ext/RMagick/rmilist.c +234 -94
- data/ext/RMagick/rmimage.c +1719 -2564
- data/ext/RMagick/rminfo.c +433 -619
- data/ext/RMagick/rmmain.c +249 -487
- data/ext/RMagick/rmutil.c +344 -563
- data/lib/RMagick.rb +414 -358
- data/lib/rvg/clippath.rb +2 -2
- data/lib/rvg/container.rb +2 -2
- data/lib/rvg/describable.rb +2 -2
- data/lib/rvg/embellishable.rb +2 -2
- data/lib/rvg/misc.rb +3 -3
- data/lib/rvg/paint.rb +2 -7
- data/lib/rvg/pathdata.rb +2 -2
- data/lib/rvg/rvg.rb +2 -2
- data/lib/rvg/stretchable.rb +2 -14
- data/lib/rvg/stylable.rb +2 -2
- data/lib/rvg/text.rb +2 -2
- data/lib/rvg/transformable.rb +2 -2
- data/lib/rvg/units.rb +2 -2
- data/{metaconfig.in → metaconfig} +0 -1
- data/post-setup.rb +1 -1
- data/rmagick.gemspec +6 -9
- metadata +41 -49
- data/Makefile.in +0 -42
- data/configure +0 -12358
- data/configure.ac +0 -791
- data/ext/RMagick/extconf.rb.in +0 -25
- data/ext/RMagick/rmagick_config.h.in +0 -285
- data/gem_extconf.rb +0 -42
data/doc/rvg.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: RVG Class</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="rvgtut.html">Prev</a> | <a href=
|
@@ -620,7 +620,7 @@ canvas.background_position = :scaled
|
|
620
620
|
When the value of the <code>meet_or_slice</code> argument
|
621
621
|
is 'meet' or 'slice', this argument controls the placement
|
622
622
|
of the content within the viewport. The <code>align</code>
|
623
|
-
argument is the concatenation of an <em>x</em>-
|
623
|
+
argument is the concatenation of an <em>x</em>-aligment and
|
624
624
|
a <em>y</em>-alignment. The values are shown in these
|
625
625
|
lists:
|
626
626
|
|
data/doc/rvgclip.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: RVG::ClipPath Class</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="rvgpattern.html">Prev</a> | <a href=
|
data/doc/rvggroup.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: RVG::Group Class</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="rvg.html">Prev</a> | <a href=
|
data/doc/rvgimage.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: RVG::Image Class</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="rvggroup.html">Prev</a> | <a href=
|
@@ -192,7 +192,7 @@
|
|
192
192
|
When the value of the <code>meet_or_slice</code> argument
|
193
193
|
is 'meet' or 'slice', this argument controls the placement
|
194
194
|
of the image within the viewport. The <code>align</code>
|
195
|
-
argument is the concatenation of an <em>x</em>-
|
195
|
+
argument is the concatenation of an <em>x</em>-aligment and
|
196
196
|
a <em>y</em>-alignment. The values are shown in these
|
197
197
|
lists:
|
198
198
|
|
data/doc/rvgpattern.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: RVG::Pattern Class</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="rvgimage.html">Prev</a> | <a href=
|
@@ -196,7 +196,7 @@
|
|
196
196
|
When the value of the <code>meet_or_slice</code> argument
|
197
197
|
is 'meet' or 'slice', this argument controls the placement
|
198
198
|
of the content within the viewport. The <code>align</code>
|
199
|
-
argument is the concatenation of an <em>x</em>-
|
199
|
+
argument is the concatenation of an <em>x</em>-aligment and
|
200
200
|
a <em>y</em>-alignment. The values are shown in these
|
201
201
|
lists:
|
202
202
|
|
data/doc/rvgshape.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: Shapes</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -28,7 +28,7 @@
|
|
28
28
|
</head>
|
29
29
|
|
30
30
|
<body>
|
31
|
-
<h6 id="header">RMagick
|
31
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
32
32
|
|
33
33
|
<div class="nav">
|
34
34
|
« <a href="rvgstyle.html">Prev</a> | <a href=
|
data/doc/rvgstyle.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: Styles</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="rvguse.html">Prev</a> | <a href=
|
data/doc/rvgtext.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: RVG::Text Class</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -33,7 +33,7 @@
|
|
33
33
|
</head>
|
34
34
|
|
35
35
|
<body>
|
36
|
-
<h6 id="header">RMagick
|
36
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
37
37
|
|
38
38
|
<div class="nav">
|
39
39
|
« <a href="rvgclip.html">Prev</a> | <a href=
|
data/doc/rvgtspan.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: RVG::Tspan Class</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="rvgtext.html">Prev</a> | <a href=
|
@@ -87,7 +87,7 @@
|
|
87
87
|
|
88
88
|
<p>Tspan objects are containers, so this method yields to a
|
89
89
|
block if one is present. The only objects that a tspan can
|
90
|
-
contain are other tspans. Styles defined on a tspan
|
90
|
+
contain are other tspans. Styles defined on a tspan propogate
|
91
91
|
to any tspans contained within it.</p>
|
92
92
|
|
93
93
|
<h4>Arguments</h4>
|
@@ -206,7 +206,7 @@
|
|
206
206
|
<p>Calls <a href="#new">RVG::Tspan.new</a> to construct a tspan
|
207
207
|
and adds it to the tspan. Yields to a block if one is present,
|
208
208
|
passing the new tspan as an argument. Styles defined on the
|
209
|
-
container tspan
|
209
|
+
container tspan propogate to the contained tspan.</p>
|
210
210
|
|
211
211
|
<h4>Arguments</h4>
|
212
212
|
|
data/doc/rvgtut.html
CHANGED
@@ -3,13 +3,13 @@
|
|
3
3
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
4
4
|
|
5
5
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
6
|
-
<!-- $Id: rvgtut.html,v 1.11
|
6
|
+
<!-- $Id: rvgtut.html,v 1.11 2007/01/14 19:01:41 rmagick Exp $ -->
|
7
7
|
|
8
8
|
<head>
|
9
9
|
<meta name="generator" content=
|
10
10
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
11
11
|
|
12
|
-
<title>RMagick
|
12
|
+
<title>RMagick 2.0.0: RVG Tutorial</title>
|
13
13
|
<meta name="GENERATOR" content="Quanta Plus" />
|
14
14
|
<link rel="stylesheet" type="text/css" href="css/doc.css" />
|
15
15
|
<style type="text/css">
|
@@ -23,7 +23,7 @@
|
|
23
23
|
</head>
|
24
24
|
|
25
25
|
<body>
|
26
|
-
<h6 id="header">RMagick
|
26
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
27
27
|
|
28
28
|
<div class="nav">
|
29
29
|
« <a href="constants.html">Prev</a> | <a href=
|
@@ -380,7 +380,7 @@
|
|
380
380
|
|
381
381
|
<p>In line 16 I define the <code>stroke</code> and
|
382
382
|
<code>stroke_width</code> styles on the group. Styles defined on
|
383
|
-
the group
|
383
|
+
the group propogate to shapes within the group unless you
|
384
384
|
override them. To do that, call <code>styles</code> on the
|
385
385
|
shapes. In this group each shape has its own fill color. The
|
386
386
|
yellow circle forms the head. The <code>circle</code> method
|
data/doc/rvguse.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st March 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: RVG::Use Class</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="rvgtspan.html">Prev</a> | <a href=
|
@@ -76,7 +76,7 @@
|
|
76
76
|
"rvgpattern.html#use">RVG::Pattern</a> classes.</p>
|
77
77
|
|
78
78
|
<p>The use object is similar to a group. Any styles specified
|
79
|
-
on the use will
|
79
|
+
on the use will propogate to the referenced object. However,
|
80
80
|
styles on the referenced object will override the styles
|
81
81
|
specified on the RVG::Use object.</p>
|
82
82
|
|
data/doc/rvgxform.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: RVG Reference: Transforms</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -28,7 +28,7 @@
|
|
28
28
|
</head>
|
29
29
|
|
30
30
|
<body>
|
31
|
-
<h6 id="header">RMagick
|
31
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
32
32
|
|
33
33
|
<div class="nav">
|
34
34
|
« <a href="rvgshape.html">Prev</a> | <a href=
|
data/doc/struct.html
CHANGED
@@ -4,9 +4,9 @@
|
|
4
4
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
5
5
|
<head>
|
6
6
|
<meta name="generator" content=
|
7
|
-
"HTML Tidy for Linux/x86 (vers 1st
|
7
|
+
"HTML Tidy for Linux/x86 (vers 1st December 2004), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: Miscellaneous classes</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -27,7 +27,7 @@
|
|
27
27
|
</head>
|
28
28
|
|
29
29
|
<body>
|
30
|
-
<h6 id="header">RMagick
|
30
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
31
31
|
|
32
32
|
<div class="nav">
|
33
33
|
« <a href="draw.html">Prev</a> | <a href=
|
@@ -90,6 +90,7 @@
|
|
90
90
|
|
91
91
|
<ul>
|
92
92
|
<li><a href="#MagickError">ImageMagickError</a></li>
|
93
|
+
<li><a href="#DestroyedImageError">DestroyedImageError</a></li>
|
93
94
|
</ul>
|
94
95
|
</div>
|
95
96
|
|
@@ -129,7 +130,7 @@
|
|
129
130
|
<p>The easiest way to use an <code>Image::View</code> object
|
130
131
|
is to create it with the <a href=
|
131
132
|
"image3.html#view">Image#view</a> method, which provides a
|
132
|
-
block-scoped view and automatic
|
133
|
+
block-scoped view and automatic sync'ing. You probably won't
|
133
134
|
want to create a view by calling <code>new</code>.</p>
|
134
135
|
|
135
136
|
<h5>Arguments</h5>
|
@@ -221,7 +222,7 @@
|
|
221
222
|
pixels = view[3][]
|
222
223
|
# Use arrays to specify a non-contiguous set of rows and columns
|
223
224
|
pixels = view[[1,3,5]][[2,4,6]]
|
224
|
-
# Use ranges to specify a
|
225
|
+
# Use ranges to specify a contigous set of rows and columns
|
225
226
|
pixels = view[1..5][2..6]
|
226
227
|
</pre>
|
227
228
|
</div>
|
@@ -326,8 +327,8 @@
|
|
326
327
|
<h5>Examples</h5>
|
327
328
|
<pre>
|
328
329
|
# Set the red channel of all the pixels in the 2nd
|
329
|
-
# row of the view to
|
330
|
-
view[1][].red =
|
330
|
+
# row of the view to QuantumRange
|
331
|
+
view[1][].red = QuantumRange
|
331
332
|
# Set the green channel of the pixel at [20][30] to
|
332
333
|
# half that of its left-hand neighbor.
|
333
334
|
view[20][30].green = view[20][29].green * 0.5
|
@@ -413,8 +414,8 @@
|
|
413
414
|
<h3>Introduction</h3>
|
414
415
|
|
415
416
|
<p>The Geometry class contains the same information as an
|
416
|
-
|
417
|
-
string</a>. Geometry objects are
|
417
|
+
ImageMagick <a href="imusage.html#geometry">geometry
|
418
|
+
string</a>. Geometry objects are interchangable with geometry
|
418
419
|
strings.</p>
|
419
420
|
</div>
|
420
421
|
|
@@ -578,7 +579,7 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
|
|
578
579
|
<h3>Introduction</h3>
|
579
580
|
|
580
581
|
<p>A pixel describes the smallest individually addressable
|
581
|
-
part of an image. In the
|
582
|
+
part of an image. In the RBG <a href=
|
582
583
|
"constants.html#ColorspaceType">colorspace</a>, a pixel's
|
583
584
|
color is described by its intensity in the red, green, and
|
584
585
|
blue channels. Its opacity is described by its intensity in
|
@@ -586,7 +587,7 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
|
|
586
587
|
CMYK colorspace a pixel's color is described by its intensity
|
587
588
|
in the cyan, magenta, yellow and black (K) channels.
|
588
589
|
Intensity is a value between 0 and <a href=
|
589
|
-
"constants.html#
|
590
|
+
"constants.html#QuantumRange">QuantumRange</a>.</p>
|
590
591
|
|
591
592
|
<p>Usually, RMagick methods operate on entire images or on
|
592
593
|
groups of pixels that have been selected by their position or
|
@@ -615,7 +616,7 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
|
|
615
616
|
<p>Constructs a pixel object from the specified red, green,
|
616
617
|
blue, and opacity intensities. The intensity is a number
|
617
618
|
between 0 and <a href=
|
618
|
-
"constants.html#Miscellaneous_constants">
|
619
|
+
"constants.html#Miscellaneous_constants">QuantumRange</a>.</p>
|
619
620
|
|
620
621
|
<h5>Attributes</h5>
|
621
622
|
|
@@ -766,7 +767,7 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
|
|
766
767
|
</div>
|
767
768
|
|
768
769
|
<div class="sig">
|
769
|
-
<h4
|
770
|
+
<h4>to_color</h4>
|
770
771
|
|
771
772
|
<p><span class="arg">pixel</span>.to_color(<span class=
|
772
773
|
"arg">compliance</span>=AllCompliance, <span class=
|
@@ -803,8 +804,8 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
|
|
803
804
|
<dt>depth</dt>
|
804
805
|
|
805
806
|
<dd>An image depth. The default is the quantum depth used
|
806
|
-
when
|
807
|
-
be used only when
|
807
|
+
when ImageMagick was compiled. The values 16 and 32 can
|
808
|
+
be used only when ImageMagick was compiled with the
|
808
809
|
appropriate QuantumDepth.</dd>
|
809
810
|
</dl>
|
810
811
|
|
@@ -1249,22 +1250,18 @@ g = Magick::Geometry.new(100,200,nil,nil,Magick::AspectGeometry)
|
|
1249
1250
|
<div class="desc">
|
1250
1251
|
<h4>Description</h4>
|
1251
1252
|
|
1252
|
-
<p>When an
|
1253
|
-
RMagick raises
|
1253
|
+
<p>When an ImageMagick function returns an error condition,
|
1254
|
+
RMagick raises this
|
1254
1255
|
exception.</p>
|
1255
|
-
|
1256
|
-
<h4>Attributes</h4>
|
1257
|
-
|
1258
|
-
<dl>
|
1259
|
-
<dt>magick_location</dt>
|
1260
|
-
|
1261
|
-
<dd>With GraphicsMagick 1.1, this attribute contains a
|
1262
|
-
string that indicates the source file (module), function
|
1263
|
-
and line number in which GraphicsMagick raised the error.
|
1264
|
-
The string is in the form <tt><function> at
|
1265
|
-
<module>:<line></tt>. (Get-only.)</dd>
|
1266
|
-
</dl>
|
1267
1256
|
</div>
|
1257
|
+
|
1258
|
+
<h3 id="DestroyedImageError">class DestroyedImageError
|
1259
|
+
<span class="superclass">< StandardError</span></h3>
|
1260
|
+
<div class="desc">
|
1261
|
+
<h4>Description</h4>
|
1262
|
+
<p>When any Image method (except <a href="image1.html#destroyed_q">destroyed?</a> and <a href="image2.html#inspect">inspect</a>) is
|
1263
|
+
called after an image has been <a href="image1.html#destroy_bang">destroyed</a>, RMagick raises this
|
1264
|
+
exception.</p>
|
1268
1265
|
</div>
|
1269
1266
|
|
1270
1267
|
<p class="spacer"> </p>
|
data/doc/usage.html
CHANGED
@@ -4,9 +4,9 @@
|
|
4
4
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
5
5
|
<head>
|
6
6
|
<meta name="generator" content=
|
7
|
-
"HTML Tidy for Linux/x86 (vers
|
7
|
+
"HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick
|
9
|
+
<title>RMagick 2.0.0: How to use RMagick</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -90,7 +90,7 @@
|
|
90
90
|
</head>
|
91
91
|
|
92
92
|
<body>
|
93
|
-
<h6 id="header">RMagick
|
93
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
94
94
|
|
95
95
|
<div class="nav">
|
96
96
|
« <a href="index.html">Prev</a> | <a href=
|
@@ -148,7 +148,7 @@
|
|
148
148
|
"#rubygems">2</a></span> the RMagick.rb file, which defines the
|
149
149
|
<b>Magick</b> module. The Magick module contains 3 major classes,
|
150
150
|
<b>ImageList</b>, <b>Image</b>, and <b>Draw</b>. This section -
|
151
|
-
<em>Basic
|
151
|
+
<em>Basic Comcepts</em> - describes the ImageList and Image
|
152
152
|
classes. The Draw class is explained in the <em><a href=
|
153
153
|
"#drawing">Drawing on and adding text to images</a></em> section,
|
154
154
|
below.</p>
|
@@ -231,8 +231,8 @@
|
|
231
231
|
|
232
232
|
<p>The statement on line 7 writes the image to a file. Notice
|
233
233
|
that the filename extension is <code>gif</code>. When writing
|
234
|
-
images,
|
235
|
-
|
234
|
+
images, ImageMagick uses the filename extension to determine what
|
235
|
+
image format to write. In this example, the
|
236
236
|
<code>Small-Cheetah.gif</code> file will be in the GIF format.
|
237
237
|
Notice how easy it is to covert an image from one format to
|
238
238
|
another? (For more details, see <a href=
|
@@ -377,8 +377,8 @@ exit
|
|
377
377
|
<p>The methods can be classified into the following broad groups.
|
378
378
|
ImageList method descriptions look like <span class=
|
379
379
|
"ilist">this</span>. Some of the listed methods are not available
|
380
|
-
in some releases of
|
381
|
-
|
380
|
+
in some releases of ImageMagick. See the method documentation for
|
381
|
+
details.</p>
|
382
382
|
|
383
383
|
<div id="index">
|
384
384
|
<h4>Utility methods</h4>
|
@@ -430,6 +430,11 @@ exit
|
|
430
430
|
<dd>Return the maximum and minimum intensity values for one
|
431
431
|
or more channels in the image</dd>
|
432
432
|
|
433
|
+
<dt><a href=
|
434
|
+
"image1.html#check_destroyed">check_destroyed</a></dt>
|
435
|
+
|
436
|
+
<dd>Raise an exception if the image has been destroyed</dd>
|
437
|
+
|
433
438
|
<dt><a href="image1.html#clone">clone</a></dt>
|
434
439
|
|
435
440
|
<dd>Return a shallow copy of the image</dd>
|
@@ -444,6 +449,11 @@ exit
|
|
444
449
|
<dd>Count the number of times each unique color appears in
|
445
450
|
the image</dd>
|
446
451
|
|
452
|
+
<dt><a href="image1.html#combine">combine</a></dt>
|
453
|
+
|
454
|
+
<dd>Combines the grayscale value of the pixels in each image
|
455
|
+
to form a new image.</dd>
|
456
|
+
|
447
457
|
<dt><a href="image1.html#copy">copy</a></dt>
|
448
458
|
|
449
459
|
<dd>Return a deep copy of the image</dd>
|
@@ -457,6 +467,15 @@ exit
|
|
457
467
|
|
458
468
|
<dd>Delete an ICC, IPTC, or generic profile</dd>
|
459
469
|
|
470
|
+
<dt><a href="image1.html#destroy_bang">destroy!</a></dt>
|
471
|
+
|
472
|
+
<dd>Return all memory associated with the image to the
|
473
|
+
system</dd>
|
474
|
+
|
475
|
+
<dt><a href="image1.html#destroyed_q">destroyed?</a></dt>
|
476
|
+
|
477
|
+
<dd>Has the image has been destroyed?</dd>
|
478
|
+
|
460
479
|
<dt><a href="image1.html#difference">difference</a></dt>
|
461
480
|
|
462
481
|
<dd>Compute the difference between two images</dd>
|
@@ -475,7 +494,11 @@ exit
|
|
475
494
|
|
476
495
|
<dd class="ilist">Return a shallow copy of the imagelist</dd>
|
477
496
|
|
478
|
-
<dt><a href="
|
497
|
+
<dt><a href="image2.html#each_pixel">each_pixel</a></dt>
|
498
|
+
|
499
|
+
<dd>Iterate over all the pixels in the image</dd>
|
500
|
+
|
501
|
+
<dt><a href="image2.html#each_profile">each_profile</a></dt>
|
479
502
|
|
480
503
|
<dd>Iterate over all the profiles associated with the
|
481
504
|
image</dd>
|
@@ -510,6 +533,10 @@ exit
|
|
510
533
|
|
511
534
|
<dd>Are all the pixels in the image gray?</dd>
|
512
535
|
|
536
|
+
<dt><a href="image2.html#histogram_q">histogram?</a></dt>
|
537
|
+
|
538
|
+
<dd>Does the image have <= 1024 unique colors??</dd>
|
539
|
+
|
513
540
|
<dt><a href=
|
514
541
|
"image2.html#import_pixels">import_pixels</a></dt>
|
515
542
|
|
@@ -525,7 +552,7 @@ exit
|
|
525
552
|
|
526
553
|
<dd>Are all the pixels in the image opaque?</dd>
|
527
554
|
|
528
|
-
<dt><a href="
|
555
|
+
<dt><a href="image3.html#palette_q">palette?</a></dt>
|
529
556
|
|
530
557
|
<dd>Is the image a PseudoClass type image with 256 colors or
|
531
558
|
less?</dd>
|
@@ -545,6 +572,11 @@ exit
|
|
545
572
|
<dd>Iterate over all the properties associated with the
|
546
573
|
image</dd>
|
547
574
|
|
575
|
+
<dt><a href="image3.html#separate">separate</a></dt>
|
576
|
+
|
577
|
+
<dd>Construct a grayscale image for each channel
|
578
|
+
specified</dd>
|
579
|
+
|
548
580
|
<dt><a href=
|
549
581
|
"image3.html#set_channel_depth">set_channel_depth</a></dt>
|
550
582
|
|
@@ -554,10 +586,6 @@ exit
|
|
554
586
|
|
555
587
|
<dd>Compute the 64-byte message signature for the image</dd>
|
556
588
|
|
557
|
-
<dt><a href="image3.html#statistics">statistics</a></dt>
|
558
|
-
|
559
|
-
<dd>Compute image statistics</dd>
|
560
|
-
|
561
589
|
<dt><a href="image3.html#store_pixels">store_pixels</a></dt>
|
562
590
|
|
563
591
|
<dd>Replace a region of pixels in the image</dd>
|
@@ -566,6 +594,12 @@ exit
|
|
566
594
|
|
567
595
|
<dd>Strip the image of all comments and profiles</dd>
|
568
596
|
|
597
|
+
<dt><a href=
|
598
|
+
"image3.html#sync_profiles">sync_profiles</a></dt>
|
599
|
+
|
600
|
+
<dd>Synchronize the image properties with the image
|
601
|
+
profiles</dd>
|
602
|
+
|
569
603
|
<dt><a href=
|
570
604
|
"image3.html#unique_colors">unique_colors</a></dt>
|
571
605
|
|
@@ -585,11 +619,6 @@ exit
|
|
585
619
|
<dd>Remove duplicate or unused entries in the image's
|
586
620
|
colormap</dd>
|
587
621
|
|
588
|
-
<dt><a href=
|
589
|
-
"image2.html#grayscale_pseudo_class">grayscale_pseudo_class</a></dt>
|
590
|
-
|
591
|
-
<dd>Convert the image to a grayscale PseudoClass image.</dd>
|
592
|
-
|
593
622
|
<dt><a href="image2.html#map">map</a></dt>
|
594
623
|
|
595
624
|
<dd>Replace the colors of the image with the nearest colors
|
@@ -605,7 +634,7 @@ exit
|
|
605
634
|
|
606
635
|
<dd>Dither the image to a predefined pattern</dd>
|
607
636
|
|
608
|
-
<dt><a href="
|
637
|
+
<dt><a href="image3.html#posterize">posterize</a></dt>
|
609
638
|
|
610
639
|
<dd>Reduce the number of colors for a "poster" effect</dd>
|
611
640
|
|
@@ -731,7 +760,7 @@ exit
|
|
731
760
|
<dd>Change all pixels from the specified color to a new
|
732
761
|
color</dd>
|
733
762
|
|
734
|
-
<dt><a href="
|
763
|
+
<dt><a href="image3.html#pixel_color">pixel_color</a></dt>
|
735
764
|
|
736
765
|
<dd>Get or set the color of a single pixel</dd>
|
737
766
|
|
@@ -819,6 +848,11 @@ exit
|
|
819
848
|
<dd>Composite the image onto another image as dictated by an
|
820
849
|
affine matrix</dd>
|
821
850
|
|
851
|
+
<dt class="ilist"><a href=
|
852
|
+
"ilist.html#composite_layers">composite_layers</a></dt>
|
853
|
+
|
854
|
+
<dd class="ilist">Composite two imagelists</dd>
|
855
|
+
|
822
856
|
<dt><a href="image1.html#displace">displace</a></dt>
|
823
857
|
|
824
858
|
<dd>Distort the image using a displacement map</dd>
|
@@ -827,6 +861,10 @@ exit
|
|
827
861
|
|
828
862
|
<dd>Dissolve two images into each other</dd>
|
829
863
|
|
864
|
+
<dt><a href="image2.html#extent">extent</a></dt>
|
865
|
+
|
866
|
+
<dd>Extend or crop the image over the background color.</dd>
|
867
|
+
|
830
868
|
<dt><a href="image3.html#watermark">watermark</a></dt>
|
831
869
|
|
832
870
|
<dd>Composite a watermark onto the image</dd>
|
@@ -865,6 +903,14 @@ exit
|
|
865
903
|
that include only the changed pixels between each image and
|
866
904
|
its successor</dd>
|
867
905
|
|
906
|
+
<dt><a href="image1.html#distort">distort</a></dt>
|
907
|
+
|
908
|
+
<dd>Distort the image</dd>
|
909
|
+
|
910
|
+
<dt><a href="image2.html#excerpt">excerpt</a></dt>
|
911
|
+
|
912
|
+
<dd>Excerpt a rectangle from the image</dd>
|
913
|
+
|
868
914
|
<dt class="ilist"><a href=
|
869
915
|
"ilist.html#flatten_images">flatten_images</a></dt>
|
870
916
|
|
@@ -897,6 +943,11 @@ exit
|
|
897
943
|
<h4>Enhance</h4>
|
898
944
|
|
899
945
|
<dl>
|
946
|
+
<dt><a href="image1.html#clut_channel">clut_channel</a></dt>
|
947
|
+
|
948
|
+
<dd>Replace the channel values in the image with a lookup of
|
949
|
+
its replacement value in an LUT gradient image.</dd>
|
950
|
+
|
900
951
|
<dt><a href="image1.html#contrast">contrast</a></dt>
|
901
952
|
|
902
953
|
<dd>Enhance the intensity differences between the lighter and
|
@@ -917,7 +968,8 @@ exit
|
|
917
968
|
<dd>Apply a digital filter that improves the quality of a
|
918
969
|
noisy image</dd>
|
919
970
|
|
920
|
-
<dt><a href="image2.html#equalize">equalize</a
|
971
|
+
<dt><a href="image2.html#equalize">equalize</a>, <a href=
|
972
|
+
"image2.html#equalize_channel">equalize_channel</a></dt>
|
921
973
|
|
922
974
|
<dd>Apply a histogram equalization to the image</dd>
|
923
975
|
|
@@ -1070,11 +1122,11 @@ exit
|
|
1070
1122
|
|
1071
1123
|
<dd>Add a charcoal effect</dd>
|
1072
1124
|
|
1073
|
-
<dt><a href="
|
1125
|
+
<dt><a href="image2.html#edge">edge</a></dt>
|
1074
1126
|
|
1075
1127
|
<dd>Find edges in the image</dd>
|
1076
1128
|
|
1077
|
-
<dt><a href="
|
1129
|
+
<dt><a href="image2.html#emboss">emboss</a></dt>
|
1078
1130
|
|
1079
1131
|
<dd>Add a three-dimensional effect</dd>
|
1080
1132
|
|
@@ -1091,7 +1143,7 @@ exit
|
|
1091
1143
|
|
1092
1144
|
<dd>Add an oil paint effect</dd>
|
1093
1145
|
|
1094
|
-
<dt><a href="
|
1146
|
+
<dt><a href="image3.html#polaroid">polaroid</a></dt>
|
1095
1147
|
|
1096
1148
|
<dd>Simulate a Polaroid® instant picture</dd>
|
1097
1149
|
|
@@ -1205,7 +1257,7 @@ exit
|
|
1205
1257
|
|
1206
1258
|
<p>Image and ImageList objects can be serialized using Ruby's
|
1207
1259
|
<code>Marshal</code> module. Marshaling is supported via
|
1208
|
-
|
1260
|
+
ImageMagick's Binary Large OBject functions
|
1209
1261
|
<code>ImageToBlob</code> (for dumping) and
|
1210
1262
|
<code>BlobToImage</code> (for loading).</p>
|
1211
1263
|
|
@@ -1231,7 +1283,7 @@ exit
|
|
1231
1283
|
|
1232
1284
|
<h3 id="drawing">Drawing</h3>
|
1233
1285
|
|
1234
|
-
<p
|
1286
|
+
<p>ImageMagick supports a set of 2D drawing commands that are
|
1235
1287
|
very similar to the commands and elements defined by the W3C's
|
1236
1288
|
<a href="http://www.w3.org/TR/SVG/index.html#minitoc">Scalable
|
1237
1289
|
Vector Graphics (SVG) 1.1 Specification</a>. In RMagick, each
|
@@ -1353,11 +1405,11 @@ exit
|
|
1353
1405
|
<p>Most of the time, you'll want to specify text properties such
|
1354
1406
|
as the font, its size, font styles such as italic, font weights
|
1355
1407
|
such as bold, the fill and stroke color, etc. The Draw class
|
1356
|
-
defines <a href="draw.html
|
1357
|
-
|
1358
|
-
|
1359
|
-
|
1360
|
-
|
1408
|
+
defines <a href="draw.html">attribute writers</a> for this
|
1409
|
+
purpose. You can set the desired text properties by calling the
|
1410
|
+
attribute writers before calling <code>annotate</code>, or you
|
1411
|
+
can call them in an image block associated with the
|
1412
|
+
<code>annotate</code> call.</p>
|
1361
1413
|
|
1362
1414
|
<p>The following example shows how to use <code>annotate</code>
|
1363
1415
|
to produce this image.</p>
|
@@ -1408,7 +1460,7 @@ exit
|
|
1408
1460
|
<p>First, the statements in lines 8-10 create the background. See
|
1409
1461
|
<a href="struct.html#fill"><code>Fill classes</code></a> for
|
1410
1462
|
information about the <code>TextureFill</code> class. The
|
1411
|
-
"granite:" image format is one of
|
1463
|
+
"granite:" image format is one of ImageMagick's built-in image
|
1412
1464
|
formats. See <a href="imusage.html#builtin_formats">"Built-in
|
1413
1465
|
image formats"</a> for more information. The statement on line 12
|
1414
1466
|
creates the Draw object that does the annotation. The next 3
|
@@ -1436,20 +1488,19 @@ exit
|
|
1436
1488
|
|
1437
1489
|
<h2 id="more">Where to go from here</h2>
|
1438
1490
|
|
1439
|
-
<p>The next section, <a href=
|
1440
|
-
|
1441
|
-
|
1442
|
-
|
1443
|
-
|
1444
|
-
|
1445
|
-
|
1446
|
-
|
1447
|
-
|
1448
|
-
|
1449
|
-
|
1450
|
-
|
1451
|
-
|
1452
|
-
of the methods is demonstrated in one of the examples.</p>
|
1491
|
+
<p>The next section, <a href="imusage.html">"ImageMagick
|
1492
|
+
Conventions,"</a> describes some conventions that you need to
|
1493
|
+
know, such as how ImageMagick determines the graphic format of an
|
1494
|
+
image file, etc. The ImageMagick (www.imagemagick.org) web site
|
1495
|
+
(from which much of the information in these pages has been
|
1496
|
+
taken) offers a lot of detail about ImageMagick. While this web
|
1497
|
+
sites doesn't describe RMagick, you can often use the
|
1498
|
+
documentation to learn more about a RMagick method by reading
|
1499
|
+
about the Magick API the method calls. (In the Reference section
|
1500
|
+
of this document, most of the method descriptions include the
|
1501
|
+
name of the Magick API that the method calls.) Check out the
|
1502
|
+
example programs. Almost every one of the methods is demonstrated
|
1503
|
+
in one of the examples.</p>
|
1453
1504
|
|
1454
1505
|
<p>Good luck!</p>
|
1455
1506
|
|
@@ -1486,7 +1537,7 @@ exit
|
|
1486
1537
|
use radians instead of degrees.</p>
|
1487
1538
|
</div>
|
1488
1539
|
|
1489
|
-
<p class="spacer"
|
1540
|
+
<p class="spacer"></p>
|
1490
1541
|
|
1491
1542
|
<div class="nav">
|
1492
1543
|
« <a href="index.html">Prev</a> | <a href=
|