rmagick 2.2.2 → 2.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.
- data/ChangeLog +17 -0
- data/README.html +21 -46
- data/README.txt +18 -40
- data/build_tarball.rake +11 -2
- data/doc/comtasks.html +5 -5
- data/doc/constants.html +272 -241
- data/doc/draw.html +5 -5
- data/doc/ex/mask.rb +2 -2
- data/doc/ilist.html +9 -9
- data/doc/image1.html +164 -16
- data/doc/image2.html +105 -8
- data/doc/image3.html +8 -8
- data/doc/imageattrs.html +4 -137
- data/doc/imusage.html +3 -3
- data/doc/index.html +9 -9
- data/doc/info.html +5 -5
- data/doc/magick.html +30 -70
- data/doc/optequiv.html +19 -39
- data/doc/rvg.html +5 -5
- 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 +6 -6
- data/doc/rvgtspan.html +4 -4
- data/doc/rvgtut.html +9 -9
- data/doc/rvguse.html +3 -3
- data/doc/rvgxform.html +2 -2
- data/doc/struct.html +54 -19
- data/doc/usage.html +11 -3
- data/ext/RMagick/MANIFEST +1 -1
- data/ext/RMagick/extconf.rb +8 -23
- data/ext/RMagick/rmagick.h +10 -5
- data/ext/RMagick/rmdraw.c +7 -8
- data/ext/RMagick/rmimage.c +186 -20
- data/ext/RMagick/rmmain.c +32 -12
- data/ext/RMagick/rmutil.c +171 -28
- data/lib/RMagick.rb +7 -7
- 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 +2 -2
- data/lib/rvg/paint.rb +7 -2
- data/lib/rvg/pathdata.rb +2 -2
- data/lib/rvg/rvg.rb +3 -3
- data/lib/rvg/stretchable.rb +15 -3
- 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/rmagick.gemspec +1 -1
- metadata +3 -3
data/ChangeLog
CHANGED
@@ -1,3 +1,20 @@
|
|
1
|
+
RMagick 2.3.0
|
2
|
+
o Added Image#encipher, Image#decipher (available with ImageMagick 6.3.8-6)
|
3
|
+
o Added DTX1Compression, DTX1Compression, and DTX1Compression
|
4
|
+
CompressionType enums (available in ImageMagick 6.3.9-4)
|
5
|
+
o Added optional "use hex format" argument to Pixel#to_color
|
6
|
+
o Support :area resource type in Magick.limit_resource
|
7
|
+
o Pixel.from_HSL and Pixel#to_HSL are deprecated. Use Pixel.from_hsla
|
8
|
+
and Pixel#to_hsla instead. The new methods rely on the ImageMagick 6.3.5
|
9
|
+
and later API.
|
10
|
+
o The Image#alpha and alpha= attributes are deprecated. Use alpha() and
|
11
|
+
alpha? instead.
|
12
|
+
o The Image#mask= attribute is deprecated. Use mask() instead.
|
13
|
+
o The use of Ruby older than version 1.8.4 with RMagick is deprecated and
|
14
|
+
will not be supported in a future release.
|
15
|
+
o Fix bug #18271, rvg width and height attributes wrong after a call to
|
16
|
+
viewbox (reported by Greg Jarman)
|
17
|
+
|
1
18
|
RMagick 2.2.2
|
2
19
|
o Fix bug #18016, add test for InitializeMagick in libMagickCore to
|
3
20
|
extconf.rb
|
data/README.html
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
2
2
|
<html>
|
3
3
|
<head>
|
4
|
-
<title>RMagick 2.
|
4
|
+
<title>RMagick 2.3.0 README</title>
|
5
5
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
6
6
|
<meta name="GENERATOR" content="BlueCloth">
|
7
7
|
</head>
|
8
8
|
<body>
|
9
|
-
<h1>RMagick 2.
|
9
|
+
<h1>RMagick 2.3.0 README</h1>
|
10
10
|
|
11
|
-
<h2>
|
11
|
+
<h2>03/29/08</h2>
|
12
12
|
|
13
13
|
<h2>Table Of Contents</h2>
|
14
14
|
|
@@ -40,52 +40,29 @@ ImageMagick image processing library.</p>
|
|
40
40
|
|
41
41
|
<p><strong>Author:</strong> Tim Hunter</p>
|
42
42
|
|
43
|
-
<p><strong>Email:</strong> <a href="&#
|
43
|
+
<p><strong>Email:</strong> <a href="mailto:rmagick@rubyforge.org">rmagick@rubyforge.org</a></p>
|
44
44
|
|
45
45
|
<p><strong>RubyForge:</strong> <a href="http://rubyforge.org/projects/rmagick/">http://rubyforge.org/projects/rmagick/</a></p>
|
46
46
|
|
47
47
|
<h2 id="new">What's new?</h2>
|
48
48
|
|
49
|
-
<p>RMagick 2.
|
50
|
-
|
51
|
-
|
52
|
-
<ul>
|
53
|
-
<li>The installation procedure is pure Ruby.</li>
|
54
|
-
<li>The minimum version of Ruby is 1.8.2.</li>
|
55
|
-
<li>The minimum version of ImageMagick is 6.3.0.</li>
|
56
|
-
<li>GraphicsMagick is not supported.</li>
|
57
|
-
<li>The following GraphicsMagick-only methods are no longer available:
|
58
|
-
Image#grayscale_pseudo_class, Image#statistics.</li>
|
59
|
-
<li>The following deprecated methods are no longer available:
|
60
|
-
Image#random_channel_threshold, Image#channel_threshold, Image#montage=,
|
61
|
-
Image#image_type=, Image::Info#tile_info, Image#tile_info=,
|
62
|
-
Image::Info#tile, Image::Info#tile=, Image::Info#subimage, Image::Info#subimage=,
|
63
|
-
Image::Info#subrange, Image::Info#subrange=, Magick.set_monitor.</li>
|
64
|
-
<li>The following methods have been added:
|
65
|
-
Image::Info#stroke=, Image::Info#stroke_width= and Image::Info#undercolor=,
|
66
|
-
Draw#fill_pattern= and Draw#stroke_pattern=, Image#destroy!, Image#destroyed?,
|
67
|
-
Image#check_destroyed, Magick.trace_proc, Image.combine, Image#separate,
|
68
|
-
Image#distort, Image#each_pixel.</li>
|
69
|
-
<li>Magick::MaxRGB is deprecated (but still available). Use Magick::QuantumRange
|
70
|
-
instead.</li>
|
71
|
-
<li>RMagick works with the Q32 version of ImageMagick.</li>
|
72
|
-
</ul>
|
73
|
-
|
74
|
-
<p>Various other minor bug fixes and upgrades.</p>
|
49
|
+
<p>RMagick 2.0.0 incorporates all changes and bug fixes from RMagick 1.15.13.
|
50
|
+
See the ChangeLog for additional changes and bug fixes in later releases.</p>
|
75
51
|
|
76
52
|
<h2 id="prereq">Prerequisites</h2>
|
77
53
|
|
78
54
|
<p><strong>O/S:</strong> Linux, Sun Solaris, Cygwin, FreeBSD, OS X.</p>
|
79
55
|
|
80
|
-
<p><strong>Ruby</strong> 1.8.2 or later. You can get Ruby from <a href="http://www.ruby-lang.org">http://www.ruby-lang.org</a
|
56
|
+
<p><strong>Ruby</strong> 1.8.2 or later. You can get Ruby from <a href="http://www.ruby-lang.org">http://www.ruby-lang.org</a>.
|
57
|
+
The use of versions of Ruby older than 1.8.4 is deprecated and may be
|
58
|
+
removed in a future release.</p>
|
81
59
|
|
82
60
|
<p><strong>ImageMagick</strong> 6.3.0 or later. You can get ImageMagick from
|
83
61
|
<a href="http://www.imagemagick.org">http://www.imagemagick.org</a>.</p>
|
84
62
|
|
85
63
|
<h2 id="install">Installation</h2>
|
86
64
|
|
87
|
-
<p>
|
88
|
-
in earlier releases. Before installing RMagick, you must install ImageMagick.
|
65
|
+
<p>Before installing RMagick, you must install ImageMagick.
|
89
66
|
Complete and up-to-date instructions for installing ImageMagick on Linux,
|
90
67
|
*BSD, and other *nix-type O/S's are available
|
91
68
|
at <a href="http://rmagick.rubyforge.org/install-linux.html">http://rmagick.rubyforge.org/install-linux.html</a>, steps 0, 1, 2.
|
@@ -94,7 +71,7 @@ on OS X are available at <a href="http://rmagick.rubyforge.org/install-osx.html"
|
|
94
71
|
steps 1 and 2. After installing
|
95
72
|
ImageMagick, use the instructions in the next section to install RMagick.</p>
|
96
73
|
|
97
|
-
<h2 id="install">Installing RMagick 2.
|
74
|
+
<h2 id="install">Installing RMagick 2.3.0</h2>
|
98
75
|
|
99
76
|
<p>This release of RMagick uses Minero Aoki's setup.rb script for installation.
|
100
77
|
See the next section for configuration options. Usually you do not need to
|
@@ -102,17 +79,15 @@ specify any of these options. You can get more information about setup.rb from
|
|
102
79
|
his web site <a href="http://i.loveruby.net">http://i.loveruby.net</a></p>
|
103
80
|
|
104
81
|
<p>I assume you've already decompressed the tarball, or you wouldn't be reading
|
105
|
-
this. If you have not decompressed the tarball, do so with
|
106
|
-
|
107
|
-
<pre><code>tar xvzf RMagick-2.2.2-tar.gz
|
108
|
-
</code></pre>
|
109
|
-
|
110
|
-
<p>or</p>
|
82
|
+
this. If you have not decompressed the tarball, do so with one of these commands,
|
83
|
+
depending on which tarball you have:</p>
|
111
84
|
|
112
|
-
<pre><code>tar
|
85
|
+
<pre><code>tar xvzf RMagick-2.3.0-tar.gz (gzipped tarball)
|
86
|
+
tar xvjf RMagick-2.3.0-tar.bz2 (bzipped tarball)
|
87
|
+
7z e RMagick-x.y.z.tar.lzma -so | tar xv (7zipped tarball)
|
113
88
|
</code></pre>
|
114
89
|
|
115
|
-
<p>Change to the RMagick-2.
|
90
|
+
<p>Change to the RMagick-2.3.0 directory. If you are not using any
|
116
91
|
configuration options (usually you don't need to) enter the command</p>
|
117
92
|
|
118
93
|
<pre><code>ruby setup.rb
|
@@ -179,9 +154,9 @@ the problem. Also see <a href="http://rmagick.rubyforge.org/install-faq.html#lib
|
|
179
154
|
|
180
155
|
<p>When make is running the examples, if you get a message like this:</p>
|
181
156
|
|
182
|
-
<pre><code>/home/you/RMagick-2.
|
157
|
+
<pre><code>/home/you/RMagick-2.3.0/lib/RMagick.rb:11:in `require': libMagick.so.0:
|
183
158
|
cannot open shared object file: No such file or directory -
|
184
|
-
/home/you/RMagick-2.
|
159
|
+
/home/you/RMagick-2.3.0/ext/RMagick/RMagick.so (LoadError)
|
185
160
|
</code></pre>
|
186
161
|
|
187
162
|
<p>you probably do not have the directory in which the ImageMagick library
|
@@ -201,7 +176,7 @@ systems, see the documentation for the dynamic loading facility.</p>
|
|
201
176
|
|
202
177
|
<p>When make is running the examples, if you get a message like this:</p>
|
203
178
|
|
204
|
-
<pre><code>hook /home/me/src/RMagick-2.
|
179
|
+
<pre><code>hook /home/me/src/RMagick-2.3.0/./post-setup.rb failed:
|
205
180
|
No such file or directory - "/tmp/rmagick6872.6"
|
206
181
|
</code></pre>
|
207
182
|
|
@@ -251,7 +226,7 @@ getting help for ImageMagick is available at the ImageMagick web site
|
|
251
226
|
<h2 id="license">License</h2>
|
252
227
|
|
253
228
|
<blockquote>
|
254
|
-
<p>Copyright � 2002-
|
229
|
+
<p>Copyright � 2002-2008 by Timothy P. Hunter</p>
|
255
230
|
|
256
231
|
<p>Permission is hereby granted, free of charge, to any person obtaining a
|
257
232
|
copy of this software and associated documentation files (the "Software"),
|
data/README.txt
CHANGED
@@ -1,6 +1,6 @@
|
|
1
|
-
RMagick 2.
|
1
|
+
RMagick 2.3.0 README
|
2
2
|
================================
|
3
|
-
|
3
|
+
03/29/08
|
4
4
|
--------
|
5
5
|
|
6
6
|
Table Of Contents
|
@@ -35,44 +35,23 @@ __Email:__ <rmagick@rubyforge.org>
|
|
35
35
|
__RubyForge:__ <http://rubyforge.org/projects/rmagick/>
|
36
36
|
|
37
37
|
<h2 id="new">What's new?</h2>
|
38
|
-
RMagick 2.
|
39
|
-
|
40
|
-
|
41
|
-
* The installation procedure is pure Ruby.
|
42
|
-
* The minimum version of Ruby is 1.8.2.
|
43
|
-
* The minimum version of ImageMagick is 6.3.0.
|
44
|
-
* GraphicsMagick is not supported.
|
45
|
-
* The following GraphicsMagick-only methods are no longer available:
|
46
|
-
Image#grayscale\_pseudo\_class, Image#statistics.
|
47
|
-
* The following deprecated methods are no longer available:
|
48
|
-
Image#random\_channel\_threshold, Image#channel\_threshold, Image#montage=,
|
49
|
-
Image#image\_type=, Image::Info#tile\_info, Image#tile\_info=,
|
50
|
-
Image::Info#tile, Image::Info#tile=, Image::Info#subimage, Image::Info#subimage=,
|
51
|
-
Image::Info#subrange, Image::Info#subrange=, Magick.set_monitor.
|
52
|
-
* The following methods have been added:
|
53
|
-
Image::Info#stroke=, Image::Info#stroke\_width= and Image::Info#undercolor=,
|
54
|
-
Draw#fill_pattern= and Draw#stroke\_pattern=, Image#destroy!, Image#destroyed?,
|
55
|
-
Image#check\_destroyed, Magick.trace\_proc, Image.combine, Image#separate,
|
56
|
-
Image#distort, Image#each\_pixel.
|
57
|
-
* Magick::MaxRGB is deprecated (but still available). Use Magick::QuantumRange
|
58
|
-
instead.
|
59
|
-
* RMagick works with the Q32 version of ImageMagick.
|
60
|
-
|
61
|
-
Various other minor bug fixes and upgrades.
|
38
|
+
RMagick 2.0.0 incorporates all changes and bug fixes from RMagick 1.15.13.
|
39
|
+
See the ChangeLog for additional changes and bug fixes in later releases.
|
62
40
|
|
63
41
|
<h2 id="prereq">Prerequisites</h2>
|
64
42
|
|
65
43
|
__O/S:__ Linux, Sun Solaris, Cygwin, FreeBSD, OS X.
|
66
44
|
|
67
45
|
__Ruby__ 1.8.2 or later. You can get Ruby from <http://www.ruby-lang.org>.
|
46
|
+
The use of versions of Ruby older than 1.8.4 is deprecated and may be
|
47
|
+
removed in a future release.
|
68
48
|
|
69
49
|
__ImageMagick__ 6.3.0 or later. You can get ImageMagick from
|
70
50
|
<http://www.imagemagick.org>.
|
71
51
|
|
72
52
|
<h2 id="install">Installation</h2>
|
73
53
|
|
74
|
-
|
75
|
-
in earlier releases. Before installing RMagick, you must install ImageMagick.
|
54
|
+
Before installing RMagick, you must install ImageMagick.
|
76
55
|
Complete and up-to-date instructions for installing ImageMagick on Linux,
|
77
56
|
*BSD, and other *nix-type O/S's are available
|
78
57
|
at <http://rmagick.rubyforge.org/install-linux.html>, steps 0, 1, 2.
|
@@ -81,7 +60,7 @@ on OS X are available at <http://rmagick.rubyforge.org/install-osx.html>,
|
|
81
60
|
steps 1 and 2. After installing
|
82
61
|
ImageMagick, use the instructions in the next section to install RMagick.
|
83
62
|
|
84
|
-
<h2 id="install">Installing RMagick 2.
|
63
|
+
<h2 id="install">Installing RMagick 2.3.0</h2>
|
85
64
|
|
86
65
|
This release of RMagick uses Minero Aoki's setup.rb script for installation.
|
87
66
|
See the next section for configuration options. Usually you do not need to
|
@@ -89,15 +68,14 @@ specify any of these options. You can get more information about setup.rb from
|
|
89
68
|
his web site <http://i.loveruby.net>
|
90
69
|
|
91
70
|
I assume you've already decompressed the tarball, or you wouldn't be reading
|
92
|
-
this. If you have not decompressed the tarball, do so with
|
71
|
+
this. If you have not decompressed the tarball, do so with one of these commands,
|
72
|
+
depending on which tarball you have:
|
93
73
|
|
94
|
-
tar xvzf RMagick-2.
|
74
|
+
tar xvzf RMagick-2.3.0-tar.gz (gzipped tarball)
|
75
|
+
tar xvjf RMagick-2.3.0-tar.bz2 (bzipped tarball)
|
76
|
+
7z e RMagick-x.y.z.tar.lzma -so | tar xv (7zipped tarball)
|
95
77
|
|
96
|
-
|
97
|
-
|
98
|
-
tar xvjf RMagick-2.2.2-tar.bz2
|
99
|
-
|
100
|
-
Change to the RMagick-2.2.2 directory. If you are not using any
|
78
|
+
Change to the RMagick-2.3.0 directory. If you are not using any
|
101
79
|
configuration options (usually you don't need to) enter the command
|
102
80
|
|
103
81
|
ruby setup.rb
|
@@ -151,9 +129,9 @@ the problem. Also see <http://rmagick.rubyforge.org/install-faq.html#libmagick>.
|
|
151
129
|
#### Cannot open shared object file
|
152
130
|
When make is running the examples, if you get a message like this:
|
153
131
|
|
154
|
-
/home/you/RMagick-2.
|
132
|
+
/home/you/RMagick-2.3.0/lib/RMagick.rb:11:in `require': libMagick.so.0:
|
155
133
|
cannot open shared object file: No such file or directory -
|
156
|
-
/home/you/RMagick-2.
|
134
|
+
/home/you/RMagick-2.3.0/ext/RMagick/RMagick.so (LoadError)
|
157
135
|
|
158
136
|
you probably do not have the directory in which the ImageMagick library
|
159
137
|
is installed in your load path. An easy way to fix this is to define
|
@@ -170,7 +148,7 @@ systems, see the documentation for the dynamic loading facility.
|
|
170
148
|
#### No such file or directory - "/tmp/rmagick6872.6"
|
171
149
|
When make is running the examples, if you get a message like this:
|
172
150
|
|
173
|
-
hook /home/me/src/RMagick-2.
|
151
|
+
hook /home/me/src/RMagick-2.3.0/./post-setup.rb failed:
|
174
152
|
No such file or directory - "/tmp/rmagick6872.6"
|
175
153
|
|
176
154
|
you probably do not have a temporary directory environment variable set. Set
|
@@ -214,7 +192,7 @@ Thanks to
|
|
214
192
|
|
215
193
|
<h2 id="license">License</h2>
|
216
194
|
|
217
|
-
> Copyright � 2002-
|
195
|
+
> Copyright � 2002-2008 by Timothy P. Hunter
|
218
196
|
>
|
219
197
|
> Permission is hereby granted, free of charge, to any person obtaining a
|
220
198
|
> copy of this software and associated documentation files (the "Software"),
|
data/build_tarball.rake
CHANGED
@@ -185,8 +185,16 @@ task :collateral => ["README.html", :gemspec, :extconf, :doc]
|
|
185
185
|
GEM = Dist_Directory.downcase + ".gem"
|
186
186
|
|
187
187
|
task :default => [:export, :collateral, :fix_files, :manifest] do
|
188
|
-
sh "tar
|
189
|
-
sh "tar
|
188
|
+
sh "tar czf #{Release}.tar.gz #{Dist_Directory}"
|
189
|
+
sh "tar cjf #{Release}.tar.bz2 #{Dist_Directory}"
|
190
|
+
sh "tar c #{Release} | 7z a -t7z -m0=lzma -mx=9 -mfb=64 -ms=on -si#{Release}.tar #{Release}.tar.lzma"
|
191
|
+
|
192
|
+
# Extract with
|
193
|
+
# 7z e RMagick-x.y.z.tar.lzma -so | tar xv
|
194
|
+
#sh "tar cf #{Release}.tar #{Dist_Directory}"
|
195
|
+
#sh "7z a -t7z -m0=lzma -mx=9 -mfb=64 -md=32m -ms=on #{Release}.tar.lzma #{Release}.tar"
|
196
|
+
#rm_rf Release+".tar", :verbose => true
|
197
|
+
|
190
198
|
Dir.chdir(Dist_Directory) do
|
191
199
|
sh "gem build rmagick.gemspec"
|
192
200
|
mv GEM, "../", :verbose => true
|
@@ -200,6 +208,7 @@ task :clean do
|
|
200
208
|
rm_rf Dist_Directory, :verbose => true
|
201
209
|
rm_rf Release+".tar.gz", :verbose => true
|
202
210
|
rm_rf Release+".tar.bz2", :verbose => true
|
211
|
+
rm_rf Release+".tar.lzma", :verbose => true
|
203
212
|
rm_rf GEM, :verbose => true
|
204
213
|
end
|
205
214
|
|
data/doc/comtasks.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick 2.
|
9
|
+
<title>RMagick 2.3.0: Common Tasks</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -31,7 +31,7 @@
|
|
31
31
|
</head>
|
32
32
|
|
33
33
|
<body>
|
34
|
-
<h6 id="header">RMagick 2.
|
34
|
+
<h6 id="header">RMagick 2.3.0 User's Guide and Reference</h6>
|
35
35
|
|
36
36
|
<div class="nav">
|
37
37
|
« <a href="optequiv.html">Prev</a> | <a href=
|
@@ -108,7 +108,7 @@ ARGV.each { |file|
|
|
108
108
|
<h2 id="convert">Converting an image to another format</h2>
|
109
109
|
|
110
110
|
<p>Converting an image to another format is as simple as writing
|
111
|
-
the image to a file.
|
111
|
+
the image to a file. ImageMagick uses the output filename
|
112
112
|
suffix (".jpg" for JPEG, ".gif" for GIF, for example) or prefix
|
113
113
|
("ps:" for PostScript, for example) to determine the format of
|
114
114
|
the output image.</p>
|
@@ -175,7 +175,7 @@ thumb = img.resize_to_fill(75, 75)
|
|
175
175
|
method can help.</p>
|
176
176
|
|
177
177
|
<p>The <code>change_geometry</code> method accepts an
|
178
|
-
|
178
|
+
ImageMagick <a href="imusage.html#geometry">geometry string</a>
|
179
179
|
argument and a block. The geometry string specifies how to change
|
180
180
|
the image's size: one or two numbers to specify the new size and
|
181
181
|
optional flags to describe any constraints. The
|
@@ -252,7 +252,7 @@ thumb = img.resize_to_fit(75, 75)
|
|
252
252
|
compress an image using ZipCompression, more compression usually
|
253
253
|
takes longer.</p>
|
254
254
|
|
255
|
-
<p>For more information, see the
|
255
|
+
<p>For more information, see the ImageMagick documentation for
|
256
256
|
the <code>-quality</code> option to the utility commands.</p>
|
257
257
|
<pre class="example">
|
258
258
|
img.write("myimage.jpg") { self.quality = 50 }
|
data/doc/constants.html
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
<meta name="generator" content=
|
7
7
|
"HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
|
8
8
|
|
9
|
-
<title>RMagick 2.
|
9
|
+
<title>RMagick 2.3.0: Constants</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -61,7 +61,7 @@
|
|
61
61
|
</head>
|
62
62
|
|
63
63
|
<body>
|
64
|
-
<h6 id="header">RMagick 2.
|
64
|
+
<h6 id="header">RMagick 2.3.0 User's Guide and Reference</h6>
|
65
65
|
|
66
66
|
<div class="nav">
|
67
67
|
« <a href="info.html">Prev</a> | <a href=
|
@@ -155,7 +155,7 @@
|
|
155
155
|
|
156
156
|
<dd>An extended form of the <code>Version</code> constant with
|
157
157
|
the format shown here:<br />
|
158
|
-
<code>This is RMagick 2.0.0 ($Date: 2008/
|
158
|
+
<code>This is RMagick 2.0.0 ($Date: 2008/03/16 15:21:45 $)
|
159
159
|
Copyright (C) 2008 by Timothy P. Hunter<br />
|
160
160
|
Built with ImageMagick 6.3.7 01/05/08 Q16
|
161
161
|
http://www.imagemagick.org<br />
|
@@ -228,16 +228,32 @@
|
|
228
228
|
<dl>
|
229
229
|
<dt>UndefinedAlign</dt>
|
230
230
|
|
231
|
+
<dd>No alignment specified. Equivalent to LeftAlign.</dd>
|
232
|
+
|
231
233
|
<dt>LeftAlign</dt>
|
232
234
|
|
235
|
+
<dd>Align the leftmost part of the text to the starting
|
236
|
+
point.</dd>
|
237
|
+
|
233
238
|
<dt>CenterAlign</dt>
|
234
239
|
|
240
|
+
<dd>Center the text around the starting point.</dd>
|
241
|
+
|
235
242
|
<dt>RightAlign</dt>
|
243
|
+
|
244
|
+
<dd>Align the rightmost part of the text to the starting
|
245
|
+
point.</dd>
|
236
246
|
</dl>
|
237
247
|
|
238
248
|
<h3 class="const" id="ChannelType">ChannelType</h3>
|
239
249
|
|
240
|
-
<p>Specify an image channel.
|
250
|
+
<p>Specify an image channel. A channel is a color component of a
|
251
|
+
pixel. In the RGB colorspace the channels are red, green, and
|
252
|
+
blue. There may also be an alpha (transparency/opacity) channel.
|
253
|
+
In the CMYK colorspace the channels area cyan, magenta, yellow,
|
254
|
+
and black. In the HSL colorspace the channels are hue,
|
255
|
+
saturation, and lightness. In the Gray colorspace the only
|
256
|
+
channel is gray. See <a href=
|
241
257
|
"image1.html#channel">Image#channel</a> and <a href=
|
242
258
|
"info.html#channel">Image::Info#channel=</a>.</p>
|
243
259
|
|
@@ -262,6 +278,10 @@
|
|
262
278
|
|
263
279
|
<dt>AllChannels</dt>
|
264
280
|
|
281
|
+
<dd>In the RGB colorspace, the red, blue, green, and alpha
|
282
|
+
channels. In the CMYK colorspace, the cyan, magenta, yellow,
|
283
|
+
and black channels.</dd>
|
284
|
+
|
265
285
|
<dt>GrayChannel</dt>
|
266
286
|
|
267
287
|
<dt>AlphaChannel</dt>
|
@@ -333,32 +353,61 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
333
353
|
|
334
354
|
<dd>No colorspace has been specified.</dd>
|
335
355
|
|
336
|
-
<dt>
|
356
|
+
<dt>CMYColorspace</dt>
|
337
357
|
|
338
|
-
<
|
358
|
+
<dt>CMYKColorspace</dt>
|
359
|
+
|
360
|
+
<dd class="imquote">Cyan-Magenta-Yellow-Black colorspace. CYMK
|
361
|
+
is a subtractive color system used by printers and
|
362
|
+
photographers for the rendering of colors with ink or emulsion,
|
363
|
+
normally on a white surface.</dd>
|
339
364
|
|
340
365
|
<dt>GRAYColorspace</dt>
|
341
366
|
|
342
367
|
<dd>Full-range grayscale</dd>
|
343
368
|
|
369
|
+
<dt>HSBColorspace</dt>
|
370
|
+
|
371
|
+
<dt>HSLColorspace</dt>
|
372
|
+
|
373
|
+
<dd>Hue, saturation, luminosity</dd>
|
374
|
+
|
375
|
+
<dt>HWBColorspace</dt>
|
376
|
+
|
377
|
+
<dd>Hue, whiteness, blackness</dd>
|
378
|
+
|
379
|
+
<dt>LABColorspace</dt>
|
380
|
+
|
381
|
+
<dt>LogColorspace</dt>
|
382
|
+
|
383
|
+
<dt>OHTAColorspace</dt>
|
384
|
+
|
385
|
+
<dt>RGBColorspace</dt>
|
386
|
+
|
387
|
+
<dd class="imquote">Red-Green-Blue colorspace</dd>
|
388
|
+
|
389
|
+
<dt>SRGBColorspace</dt>
|
390
|
+
|
391
|
+
<dd>Kodak PhotoCD sRGB. In ImageMagick, this constant is named
|
392
|
+
sRGBColorspace, but since Ruby constants must start with an
|
393
|
+
uppercase letter, I had to change it.</dd>
|
394
|
+
|
344
395
|
<dt>TransparentColorspace</dt>
|
345
396
|
|
346
397
|
<dd class="imquote">The Transparent color space behaves
|
347
398
|
uniquely in that it preserves the matte channel of the image if
|
348
399
|
it exists.</dd>
|
349
400
|
|
350
|
-
<dt>OHTAColorspace</dt>
|
351
|
-
|
352
401
|
<dt>XYZColorspace</dt>
|
353
402
|
|
354
403
|
<dd>CIE XYZ</dd>
|
355
404
|
|
405
|
+
<dt>YCbCrColorspace</dt>
|
406
|
+
|
356
407
|
<dt>YCCColorspace</dt>
|
357
408
|
|
358
409
|
<dd>Kodak PhotoCD PhotoYCC</dd>
|
359
410
|
|
360
|
-
<dt>YCbCrColorspace</dt>
|
361
|
-
|
362
411
|
<dt>YIQColorspace</dt>
|
363
412
|
|
364
413
|
<dt>YPbPrColorspace</dt>
|
@@ -368,33 +417,6 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
368
417
|
<dd class="imquote">Y-signal, U-signal, and V-signal
|
369
418
|
colorspace. YUV is most widely used to encode color for use in
|
370
419
|
television transmission.</dd>
|
371
|
-
|
372
|
-
<dt>CMYKColorspace</dt>
|
373
|
-
|
374
|
-
<dd class="imquote">Cyan-Magenta-Yellow-Black colorspace. CYMK
|
375
|
-
is a subtractive color system used by printers and
|
376
|
-
photographers for the rendering of colors with ink or emulsion,
|
377
|
-
normally on a white surface.</dd>
|
378
|
-
|
379
|
-
<dt>SRGBColorspace</dt>
|
380
|
-
|
381
|
-
<dd>Kodak PhotoCD sRGB. In ImageMagick, this constant is named
|
382
|
-
sRGBColorspace, but since Ruby constants must start with an
|
383
|
-
uppercase letter, I had to change it.</dd>
|
384
|
-
|
385
|
-
<dt>HSLColorspace</dt>
|
386
|
-
|
387
|
-
<dd>Hue, saturation, luminosity</dd>
|
388
|
-
|
389
|
-
<dt>HWBColorspace</dt>
|
390
|
-
|
391
|
-
<dd>Hue, whiteness, blackness</dd>
|
392
|
-
|
393
|
-
<dt>HSBColorspace</dt>
|
394
|
-
|
395
|
-
<dt>LogColorspace</dt>
|
396
|
-
|
397
|
-
<dt>LABColorspace</dt>
|
398
420
|
</dl>
|
399
421
|
|
400
422
|
<p>The colorspaces in this group are typically associated with
|
@@ -458,26 +480,11 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
458
480
|
|
459
481
|
<dd>No composite operator has been specified.</dd>
|
460
482
|
|
461
|
-
<dt>
|
462
|
-
|
463
|
-
<dd><span class="imquote">The result is the union of the the
|
464
|
-
two image shapes with <code>composite image</code> obscuring
|
465
|
-
<code>image</code> in the region of overlap.</span> The matte
|
466
|
-
channel of the composite image is respected, so that if the
|
467
|
-
composite pixel is part or all transparent, the corresponding
|
468
|
-
image pixel will show through.</dd>
|
469
|
-
|
470
|
-
<dt>InCompositeOp</dt>
|
471
|
-
|
472
|
-
<dd class="imquote">The result is simply <code>composite
|
473
|
-
image</code> cut by the shape of <code>image</code>. None of
|
474
|
-
the image data of <code>image</code> is included in the
|
475
|
-
result.</dd>
|
476
|
-
|
477
|
-
<dt>OutCompositeOp</dt>
|
483
|
+
<dt>AddCompositeOp</dt>
|
478
484
|
|
479
|
-
<dd class="imquote">The
|
480
|
-
image</code
|
485
|
+
<dd class="imquote">The result of <code>composite image</code>
|
486
|
+
+ <code>image</code>, with overflow wrapping around (mod
|
487
|
+
256).</dd>
|
481
488
|
|
482
489
|
<dt>AtopCompositeOp</dt>
|
483
490
|
|
@@ -488,77 +495,66 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
488
495
|
<code>composite image</code> outside of <code>image</code>'s
|
489
496
|
shape does not appear in the result.</dd>
|
490
497
|
|
491
|
-
<dt>
|
492
|
-
|
493
|
-
<dd class="imquote">The result is the image data from both
|
494
|
-
<code>composite image</code> and <code>image</code> that is
|
495
|
-
outside the overlap region. The overlap region will be
|
496
|
-
blank.</dd>
|
497
|
-
|
498
|
-
<dt>PlusCompositeOp</dt>
|
498
|
+
<dt>BumpmapCompositeOp</dt>
|
499
499
|
|
500
|
-
<dd class="imquote">The result
|
501
|
-
|
502
|
-
operation is independent of the matte channels.</dd>
|
500
|
+
<dd class="imquote">The result <code>image</code> shaded by
|
501
|
+
<code>composite image</code>.</dd>
|
503
502
|
|
504
|
-
<dt>
|
503
|
+
<dt>ChangeMaskCompositeOp</dt>
|
505
504
|
|
506
|
-
<dd class="imquote">
|
507
|
-
|
508
|
-
|
505
|
+
<dd class="imquote">Replace any destination pixel that is the
|
506
|
+
similar to the source image's pixel (as defined by the current
|
507
|
+
fuzz factor), with transparency.</dd>
|
509
508
|
|
510
|
-
<dt>
|
509
|
+
<dt>ClearCompositeOp</dt>
|
511
510
|
|
512
|
-
<dd
|
513
|
-
|
514
|
-
256).</dd>
|
511
|
+
<dd>Make the target image transparent. The composite image is
|
512
|
+
ignored.</dd>
|
515
513
|
|
516
|
-
<dt>
|
514
|
+
<dt>ColorBurnCompositeOp</dt>
|
517
515
|
|
518
|
-
<dd class="imquote">
|
519
|
-
|
520
|
-
The add and subtract operators can be used to perform
|
521
|
-
reversable transformations.</dd>
|
516
|
+
<dd class="imquote">Darkens the destination color to reflect
|
517
|
+
the source color. Painting with white produces no change.</dd>
|
522
518
|
|
523
|
-
<dt>
|
519
|
+
<dt>ColorDodgeCompositeOp</dt>
|
524
520
|
|
525
|
-
<dd class="imquote">
|
526
|
-
|
527
|
-
comparing two very similar images.</dd>
|
521
|
+
<dd class="imquote">Brightens the destination color to reflect
|
522
|
+
the source color. Painting with black produces no change.</dd>
|
528
523
|
|
529
|
-
<dt>
|
524
|
+
<dt>ColorizeCompositeOp</dt>
|
530
525
|
|
531
|
-
<dd class="imquote">
|
532
|
-
|
533
|
-
|
526
|
+
<dd class="imquote">Each pixel in the result image is the
|
527
|
+
combination of the brightness of the target image and the
|
528
|
+
saturation and hue of the composite image. This is the
|
529
|
+
<em>opposite</em> of LuminizeCompositeOp.</dd>
|
534
530
|
|
535
|
-
<dt>
|
531
|
+
<dt>CopyCompositeOp</dt>
|
536
532
|
|
537
|
-
<dd
|
538
|
-
<code>composite image</code>.</dd>
|
533
|
+
<dd>Replace the target image with the composite image.</dd>
|
539
534
|
|
540
|
-
<dt>
|
535
|
+
<dt>CopyBlackCompositeOp</dt>
|
541
536
|
|
542
|
-
<dd
|
543
|
-
|
537
|
+
<dd>Copy the black channel from the composite image to the
|
538
|
+
target image.</dd>
|
544
539
|
|
545
|
-
<dt>
|
540
|
+
<dt>CopyBlueCompositeOp</dt>
|
546
541
|
|
547
|
-
<dd>
|
542
|
+
<dd>Copy the blue channel from the composite image to the
|
543
|
+
target image.</dd>
|
548
544
|
|
549
|
-
<dt>
|
545
|
+
<dt>CopyCyanCompositeOp</dt>
|
550
546
|
|
551
|
-
<dd>Copy the
|
552
|
-
image.</dd>
|
547
|
+
<dd>Copy the cyan channel from the composite image to the
|
548
|
+
target image.</dd>
|
553
549
|
|
554
550
|
<dt>CopyGreenCompositeOp</dt>
|
555
551
|
|
556
552
|
<dd>Copy the green channel from the composite image to the
|
557
553
|
target image.</dd>
|
558
554
|
|
559
|
-
<dt>
|
555
|
+
<dt>CopyMagentaCompositeOp</dt>
|
560
556
|
|
561
|
-
<dd>Copy the
|
557
|
+
<dd>Copy the magenta channel from the composite image to the
|
562
558
|
target image.</dd>
|
563
559
|
|
564
560
|
<dt>CopyOpacityCompositeOp</dt>
|
@@ -570,128 +566,193 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
570
566
|
pixel's opacity to the intensity of the corresponding pixel in
|
571
567
|
the composite image.</dd>
|
572
568
|
|
573
|
-
<dt>
|
569
|
+
<dt>CopyRedCompositeOp</dt>
|
574
570
|
|
575
|
-
<dd>
|
576
|
-
|
571
|
+
<dd>Copy the red channel from the composite image to the target
|
572
|
+
image.</dd>
|
577
573
|
|
578
|
-
<dt>
|
574
|
+
<dt>CopyYellowCompositeOp</dt>
|
579
575
|
|
580
|
-
<dd>
|
581
|
-
|
576
|
+
<dd>Copy the yellow channel from the composite image to the
|
577
|
+
target image.</dd>
|
578
|
+
|
579
|
+
<dt>DarkenCompositeOp</dt>
|
580
|
+
|
581
|
+
<dd>Replace target image pixels with darker pixels from the
|
582
|
+
composite image.</dd>
|
583
|
+
|
584
|
+
<dt>DifferenceCompositeOp</dt>
|
585
|
+
|
586
|
+
<dd class="imquote">The result of abs(<code>composite
|
587
|
+
image</code> - <code>image</code>). This is useful for
|
588
|
+
comparing two very similar images.</dd>
|
582
589
|
|
583
590
|
<dt>DisplaceCompositeOp</dt>
|
584
591
|
|
585
592
|
<dd>Displace target image pixels as defined by a displacement
|
586
593
|
map. The operator used by the <a href=
|
587
|
-
"image1.html#displace">
|
594
|
+
"image1.html#displace">displace</a> method.</dd>
|
588
595
|
|
589
|
-
<dt>
|
596
|
+
<dt>DissolveCompositeOp</dt>
|
590
597
|
|
591
|
-
<dd>
|
592
|
-
method.</dd>
|
598
|
+
<dd>The operator used in the <a href=
|
599
|
+
"image1.html#dissolve">dissolve</a> method.</dd>
|
593
600
|
|
594
|
-
<dt>
|
601
|
+
<dt>DivideCompositeOp</dt>
|
595
602
|
|
596
603
|
<dd>?</dd>
|
597
604
|
|
598
|
-
<dt>
|
605
|
+
<dt>DstCompositeOp</dt>
|
599
606
|
|
600
|
-
<dd>
|
607
|
+
<dd class="imquote">The destination is left untouched.</dd>
|
601
608
|
|
602
|
-
<dt>
|
609
|
+
<dt>DstAtopCompositeOp</dt>
|
603
610
|
|
604
|
-
<dd>
|
605
|
-
|
611
|
+
<dd class="imquote">The part of the destination lying inside of
|
612
|
+
the source is composited over the source and replaces the
|
613
|
+
destination.</dd>
|
606
614
|
|
607
|
-
<dt>
|
615
|
+
<dt>DstInCompositeOp</dt>
|
608
616
|
|
609
|
-
<dd>
|
610
|
-
|
617
|
+
<dd class="imquote">The part of the destination lying inside of
|
618
|
+
the source replaces the destination.</dd>
|
619
|
+
|
620
|
+
<dt>DstOutCompositeOp</dt>
|
621
|
+
|
622
|
+
<dd class="imquote">The part of the destination lying outside
|
623
|
+
of the source replaces the destination.</dd>
|
624
|
+
|
625
|
+
<dt>DstOverCompositeOp</dt>
|
626
|
+
|
627
|
+
<dd class="imquote">The destination is composited over the
|
628
|
+
source and the result replaces the destination.</dd>
|
629
|
+
|
630
|
+
<dt>ExclusionCompositeOp</dt>
|
631
|
+
|
632
|
+
<dd class="imquote">Produces an effect similar to that of
|
633
|
+
'difference', but appears as lower contrast. Painting with
|
634
|
+
white inverts the destination color. Painting with black
|
635
|
+
produces no change.</dd>
|
636
|
+
|
637
|
+
<dt>HardLightCompositeOp</dt>
|
638
|
+
|
639
|
+
<dd class="imquote">Multiplies or screens the colors, dependent
|
640
|
+
on the source color value. If the source color is lighter than
|
641
|
+
0.5, the destination is lightened as if it were screened. If
|
642
|
+
the source color is darker than 0.5, the destination is
|
643
|
+
darkened, as if it were multiplied. The degree of lightening or
|
644
|
+
darkening is proportional to the difference between the source
|
645
|
+
color and 0.5. If it is equal to 0.5 the destination is
|
646
|
+
unchanged. Painting with pure black or white produces black or
|
647
|
+
white.</dd>
|
611
648
|
|
612
649
|
<dt>HueCompositeOp</dt>
|
613
650
|
|
614
|
-
<dd>Each pixel in the result image is the
|
615
|
-
hue of the target image and the saturation
|
616
|
-
the composite image.</dd>
|
651
|
+
<dd class="imquote">Each pixel in the result image is the
|
652
|
+
combination of the hue of the target image and the saturation
|
653
|
+
and brightness of the composite image.</dd>
|
617
654
|
|
618
|
-
<dt>
|
655
|
+
<dt>InCompositeOp</dt>
|
619
656
|
|
620
|
-
<dd>
|
621
|
-
|
622
|
-
the
|
657
|
+
<dd class="imquote">The result is simply <code>composite
|
658
|
+
image</code> cut by the shape of <code>image</code>. None of
|
659
|
+
the image data of <code>image</code> is included in the
|
660
|
+
result.</dd>
|
623
661
|
|
624
|
-
<dt>
|
662
|
+
<dt>LightenCompositeOp</dt>
|
625
663
|
|
626
|
-
<dd>
|
627
|
-
|
628
|
-
|
629
|
-
|
664
|
+
<dd>Replace target image pixels with lighter pixels from the
|
665
|
+
composite image.</dd>
|
666
|
+
|
667
|
+
<dt>LinearLightCompositeOp</dt>
|
668
|
+
|
669
|
+
<dd class="imquote">Increase contrast slightly with an impact
|
670
|
+
on the foreground's tonal values.</dd>
|
630
671
|
|
631
672
|
<dt>LuminizeCompositeOp</dt>
|
632
673
|
|
633
|
-
<dd>Each pixel in the result image is the
|
634
|
-
brightness of the composite image and the
|
635
|
-
the target image. This is the
|
636
|
-
ColorizeCompositeOp.</dd>
|
674
|
+
<dd class="imquote">Each pixel in the result image is the
|
675
|
+
combination of the brightness of the composite image and the
|
676
|
+
saturation and hue of the target image. This is the
|
677
|
+
<em>opposite</em> of ColorizeCompositeOp.</dd>
|
637
678
|
|
638
|
-
<dt>
|
679
|
+
<dt>MinusCompositeOp</dt>
|
639
680
|
|
640
|
-
<dd>
|
641
|
-
|
681
|
+
<dd class="imquote">The result of composite image - image, with
|
682
|
+
overflow cropped to zero. The matte chanel is ignored (set to
|
683
|
+
255, full coverage).</dd>
|
642
684
|
|
643
|
-
<dt>
|
685
|
+
<dt>ModulateCompositeOp</dt>
|
644
686
|
|
645
|
-
<dd
|
646
|
-
|
647
|
-
whilst preserving its highlights and shadows. The destination
|
648
|
-
color is not replaced, but is mixed with the source color to
|
649
|
-
reflect the lightness or darkness of the destination.</dd>
|
687
|
+
<dd>Used by the <a href="image3.html#watermark">watermark</a>
|
688
|
+
method.</dd>
|
650
689
|
|
651
|
-
<dt>
|
690
|
+
<dt>MultiplyCompositeOp</dt>
|
652
691
|
|
653
|
-
<dd>
|
654
|
-
|
692
|
+
<dd class="imquote">Multiplies the color of each target image
|
693
|
+
pixel by the color of the corresponding composite image pixel.
|
694
|
+
The result color is always darker.</dd>
|
655
695
|
|
656
|
-
<dt>
|
696
|
+
<dt>NoCompositeOp</dt>
|
657
697
|
|
658
|
-
<dd>
|
659
|
-
target image.</dd>
|
698
|
+
<dd>No composite operator has been specified.</dd>
|
660
699
|
|
661
|
-
<dt>
|
700
|
+
<dt>OutCompositeOp</dt>
|
662
701
|
|
663
|
-
<dd>
|
664
|
-
|
702
|
+
<dd class="imquote">The resulting image is <code>composite
|
703
|
+
image</code> with the shape of <code>image</code> cut out.</dd>
|
665
704
|
|
666
|
-
<dt>
|
705
|
+
<dt>OverCompositeOp</dt>
|
667
706
|
|
668
|
-
<dd>
|
669
|
-
|
707
|
+
<dd><span class="imquote">The result is the union of the the
|
708
|
+
two image shapes with <code>composite image</code> obscuring
|
709
|
+
<code>image</code> in the region of overlap.</span> The matte
|
710
|
+
channel of the composite image is respected, so that if the
|
711
|
+
composite pixel is part or all transparent, the corresponding
|
712
|
+
image pixel will show through.</dd>
|
670
713
|
|
671
|
-
<dt>
|
714
|
+
<dt>OverlayCompositeOp</dt>
|
672
715
|
|
673
|
-
<dd class="imquote">
|
674
|
-
the
|
675
|
-
destination
|
716
|
+
<dd class="imquote">Multiplies or screens the colors, dependent
|
717
|
+
on the destination color. Source colors overlay the destination
|
718
|
+
whilst preserving its highlights and shadows. The destination
|
719
|
+
color is not replaced, but is mixed with the source color to
|
720
|
+
reflect the lightness or darkness of the destination.</dd>
|
676
721
|
|
677
|
-
<dt>
|
722
|
+
<dt>PlusCompositeOp</dt>
|
678
723
|
|
679
|
-
<dd class="imquote">The
|
724
|
+
<dd class="imquote">The result is just the sum of the image
|
725
|
+
data. Output values are cropped to 255 (no overflow). This
|
726
|
+
operation is independent of the matte channels.</dd>
|
680
727
|
|
681
|
-
<dt>
|
728
|
+
<dt>ReplaceCompositeOp</dt>
|
682
729
|
|
683
|
-
<dd class="imquote">The
|
684
|
-
|
730
|
+
<dd class="imquote">The resulting image is image replaced with
|
731
|
+
composite image. Here the matte information is ignored.</dd>
|
685
732
|
|
686
|
-
<dt>
|
733
|
+
<dt>SaturateCompositeOp</dt>
|
687
734
|
|
688
|
-
<dd
|
689
|
-
of the
|
735
|
+
<dd>Each pixel in the result image is the combination of the
|
736
|
+
saturation of the target image and the hue and brightness of
|
737
|
+
the composite image.</dd>
|
690
738
|
|
691
|
-
<dt>
|
739
|
+
<dt>ScreenCompositeOp</dt>
|
692
740
|
|
693
|
-
<dd
|
694
|
-
|
741
|
+
<dd>Multiplies the inverse of each image's color
|
742
|
+
information.</dd>
|
743
|
+
|
744
|
+
<dt>SoftLightCompositeOp</dt>
|
745
|
+
|
746
|
+
<dd class="imquote">Darkens or lightens the colors, dependent
|
747
|
+
on the source color value. If the source color is lighter than
|
748
|
+
0.5, the destination is lightened. If the source color is
|
749
|
+
darker than 0.5, the destination is darkened, as if it were
|
750
|
+
burned in. The degree of darkening or lightening is
|
751
|
+
proportional to the difference between the source color and
|
752
|
+
0.5. If it is equal to 0.5, the destination is unchanged.
|
753
|
+
Painting with pure black or white produces a distinctly darker
|
754
|
+
or lighter area, but does not result in pure black or
|
755
|
+
white.</dd>
|
695
756
|
|
696
757
|
<dt>SrcAtopCompositeOp</dt>
|
697
758
|
|
@@ -718,53 +779,23 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
718
779
|
<dd class="imquote">The source is composited over the
|
719
780
|
destination.</dd>
|
720
781
|
|
721
|
-
<dt>
|
722
|
-
|
723
|
-
<dd class="imquote">Brightens the destination color to reflect
|
724
|
-
the source color. Painting with black produces no change.</dd>
|
725
|
-
|
726
|
-
<dt>ExclusionCompositeOp</dt>
|
727
|
-
|
728
|
-
<dd class="imquote">Produces an effect similar to that of
|
729
|
-
'difference', but appears as lower contrast. Painting with
|
730
|
-
white inverts the destination color. Painting with black
|
731
|
-
produces no change.</dd>
|
732
|
-
|
733
|
-
<dt>HardLightCompositeOp</dt>
|
734
|
-
|
735
|
-
<dd class="imquote">Multiplies or screens the colors, dependent
|
736
|
-
on the source color value. If the source color is lighter than
|
737
|
-
0.5, the destination is lightened as if it were screened. If
|
738
|
-
the source color is darker than 0.5, the destination is
|
739
|
-
darkened, as if it were multiplied. The degree of lightening or
|
740
|
-
darkening is proportional to the difference between the source
|
741
|
-
color and 0.5. If it is equal to 0.5 the destination is
|
742
|
-
unchanged. Painting with pure black or white produces black or
|
743
|
-
white.</dd>
|
744
|
-
|
745
|
-
<dt>SoftLightCompositeOp</dt>
|
782
|
+
<dt>SubtractCompositeOp</dt>
|
746
783
|
|
747
|
-
<dd class="imquote">
|
748
|
-
|
749
|
-
|
750
|
-
|
751
|
-
burned in. The degree of darkening or lightening is
|
752
|
-
proportional to the difference between the source color and
|
753
|
-
0.5. If it is equal to 0.5, the destination is unchanged.
|
754
|
-
Painting with pure black or white produces a distinctly darker
|
755
|
-
or lighter area, but does not result in pure black or
|
756
|
-
white.</dd>
|
784
|
+
<dd class="imquote">The result of <code>composite image</code>
|
785
|
+
- <code>image</code>, with underflow wrapping around (mod 256).
|
786
|
+
The add and subtract operators can be used to perform
|
787
|
+
reversable transformations.</dd>
|
757
788
|
|
758
|
-
<dt>
|
789
|
+
<dt>ThresholdCompositeOp</dt>
|
759
790
|
|
760
|
-
<dd
|
761
|
-
simular to the source images pixel (as defined by the current
|
762
|
-
fuzz factor), with transparency.</dd>
|
791
|
+
<dd>?</dd>
|
763
792
|
|
764
|
-
<dt>
|
793
|
+
<dt>XorCompositeOp</dt>
|
765
794
|
|
766
|
-
<dd class="imquote">
|
767
|
-
|
795
|
+
<dd class="imquote">The result is the image data from both
|
796
|
+
<code>composite image</code> and <code>image</code> that is
|
797
|
+
outside the overlap region. The overlap region will be
|
798
|
+
blank.</dd>
|
768
799
|
</dl>
|
769
800
|
|
770
801
|
<h3 class="const" id="CompressionType">CompressionType</h3>
|
@@ -772,8 +803,8 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
772
803
|
<p><span class="imquote">Express the desired compression type
|
773
804
|
when encoding an image. Be aware that most image types only
|
774
805
|
support a sub-set of the available compression types. If the
|
775
|
-
compression type specified is
|
776
|
-
ImageMagick selects a compression type
|
806
|
+
compression type specified is incompatible with the image,
|
807
|
+
ImageMagick selects a compression type compatible with the image
|
777
808
|
type.</span> See <a href=
|
778
809
|
"imageattrs.html#compression">compression</a>.</p>
|
779
810
|
|
@@ -896,7 +927,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
896
927
|
|
897
928
|
<p><span class="imquote">Used to adjust the filter algorithm used
|
898
929
|
when resizing images. Different filters experience varying
|
899
|
-
degrees of success with various images and can take
|
930
|
+
degrees of success with various images and can take significantly
|
900
931
|
different amounts of processing time. ImageMagick uses the
|
901
932
|
LanczosFilter by default since this filter has been shown to
|
902
933
|
provide the best results for most images in a reasonable amount
|
@@ -909,47 +940,47 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
909
940
|
<dl>
|
910
941
|
<dt>UndefinedFilter</dt>
|
911
942
|
|
912
|
-
<dt>
|
943
|
+
<dt>Bartlett</dt>
|
913
944
|
|
914
|
-
<dt>
|
945
|
+
<dt>BesselFilter</dt>
|
915
946
|
|
916
|
-
<dt>
|
947
|
+
<dt>BlackmanFilter</dt>
|
917
948
|
|
918
|
-
<dt>
|
949
|
+
<dt>Bohman</dt>
|
919
950
|
|
920
|
-
<dt>
|
951
|
+
<dt>BoxFilter</dt>
|
921
952
|
|
922
|
-
<dt>
|
953
|
+
<dt>CatromFilter</dt>
|
923
954
|
|
924
|
-
<dt>
|
955
|
+
<dt>CubicFilter</dt>
|
925
956
|
|
926
957
|
<dt>GaussianFilter</dt>
|
927
958
|
|
928
|
-
<dt>
|
959
|
+
<dt>HammingFilter</dt>
|
929
960
|
|
930
|
-
<dt>
|
961
|
+
<dt>HanningFilter</dt>
|
931
962
|
|
932
|
-
<dt>
|
963
|
+
<dt>HermiteFilter</dt>
|
933
964
|
|
934
|
-
<dt>
|
965
|
+
<dt>KaiserFilter</dt>
|
935
966
|
|
936
|
-
<dt>
|
967
|
+
<dt>LagrangianFilter</dt>
|
937
968
|
|
938
|
-
<dt>
|
969
|
+
<dt>LanczosFilter</dt>
|
939
970
|
|
940
|
-
<dt>
|
971
|
+
<dt>MitchellFilter</dt>
|
941
972
|
|
942
|
-
<dt>
|
973
|
+
<dt>ParzenFilter</dt>
|
943
974
|
|
944
|
-
<dt>
|
975
|
+
<dt>PointFilter</dt>
|
945
976
|
|
946
|
-
<dt>
|
977
|
+
<dt>QuadraticFilter</dt>
|
947
978
|
|
948
|
-
<dt>
|
979
|
+
<dt>SincFilter</dt>
|
949
980
|
|
950
|
-
<dt>
|
981
|
+
<dt>TriangleFilter</dt>
|
951
982
|
|
952
|
-
<dt>
|
983
|
+
<dt>WelshFilter</dt>
|
953
984
|
</dl>
|
954
985
|
|
955
986
|
<h3 class="const" id="GravityType">GravityType</h3>
|
@@ -974,7 +1005,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
974
1005
|
|
975
1006
|
<dt>NorthGravity</dt>
|
976
1007
|
|
977
|
-
<dd class="imquote">
|
1008
|
+
<dd class="imquote">Position object at top-center of
|
978
1009
|
region</dd>
|
979
1010
|
|
980
1011
|
<dt>NorthEastGravity</dt>
|
@@ -1044,7 +1075,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1044
1075
|
|
1045
1076
|
<dd class="imquote">Truecolor image</dd>
|
1046
1077
|
|
1047
|
-
<dt>
|
1078
|
+
<dt>TrueColorMatteType</dt>
|
1048
1079
|
|
1049
1080
|
<dd class="imquote">Truecolor image with opacity</dd>
|
1050
1081
|
|
@@ -1316,7 +1347,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1316
1347
|
<dt>PixelsPerInchResolution</dt>
|
1317
1348
|
|
1318
1349
|
<dd class="imquote">Density specifications are specified in
|
1319
|
-
units of pixels per inch (
|
1350
|
+
units of pixels per inch (English units).</dd>
|
1320
1351
|
|
1321
1352
|
<dt>PixelsPerCentimeterResolution</dt>
|
1322
1353
|
|
@@ -1414,7 +1445,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1414
1445
|
<dl>
|
1415
1446
|
<dt>AnyWeight</dt>
|
1416
1447
|
|
1417
|
-
<dd>No weight
|
1448
|
+
<dd>No weight specified.</dd>
|
1418
1449
|
|
1419
1450
|
<dt>NormalWeight</dt>
|
1420
1451
|
|