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/comtasks.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: 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
|
34
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
35
35
|
|
36
36
|
<div class="nav">
|
37
37
|
« <a href="optequiv.html">Prev</a> | <a href=
|
data/doc/constants.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: 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" />
|
@@ -38,7 +38,7 @@
|
|
38
38
|
}
|
39
39
|
|
40
40
|
/*
|
41
|
-
* Modify .simple_table for the
|
41
|
+
* Modify .simple_table for the QuantumRange/QuantumDepth table.
|
42
42
|
* The major differences are the centered text and the auto width.
|
43
43
|
*/
|
44
44
|
#maxrgb {
|
@@ -61,7 +61,7 @@
|
|
61
61
|
</head>
|
62
62
|
|
63
63
|
<body>
|
64
|
-
<h6 id="header">RMagick
|
64
|
+
<h6 id="header">RMagick 2.0.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,42 +155,42 @@
|
|
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 1.
|
159
|
-
Copyright (C)
|
160
|
-
Built with
|
161
|
-
http://www.
|
162
|
-
Built for ruby 1.8.
|
158
|
+
<code>This is RMagick 1.15.0 ($Date: 2007/12/26 21:44:14 $)
|
159
|
+
Copyright (C) 2007 by Timothy P. Hunter<br />
|
160
|
+
Built with ImageMagick 6.2.5 03/05/06 Q8
|
161
|
+
http://www.imagemagick.org<br />
|
162
|
+
Built for ruby 1.8.0 (2003-08-04) [i686-linux]<br />
|
163
163
|
Web page: http://rmagick.rubyforge.org<br />
|
164
|
-
Email: rmagick@rubyforge.org
|
164
|
+
Email: rmagick@rubyforge.org<br /></code></dd>
|
165
165
|
|
166
166
|
<dt>MagickVersion</dt>
|
167
167
|
|
168
|
-
<dd>The
|
168
|
+
<dd>The ImageMagick version string. This has the form:<br />
|
169
169
|
<code>@(#)ImageMagick X.Y.Z MM/DD/YY Q:16
|
170
|
-
http://www.imagemagick.org</code
|
171
|
-
or<br />
|
172
|
-
<code>GraphicsMagick X.Y.Z MM/DD/YY Q8
|
173
|
-
http://www.GraphicsMagick.org/</code></dd>
|
170
|
+
http://www.imagemagick.org</code></dd>
|
174
171
|
|
175
|
-
<dt>
|
172
|
+
<dt>QuantumRange</dt>
|
176
173
|
|
177
174
|
<dd>The maximum value of a <em>Quantum</em>. A quantum is one
|
178
175
|
of the red, green, blue, or opacity elements of a pixel in the
|
179
176
|
RGB colorspace, or cyan, yellow, magenta, or black elements in
|
180
177
|
the CYMK colorspace.</dd>
|
181
178
|
|
179
|
+
<dt>MaxRGB <i>(deprecated)</i></dt>
|
180
|
+
|
181
|
+
<dd>Same as QuantumRange.</dd>
|
182
|
+
|
182
183
|
<dt>QuantumDepth</dt>
|
183
184
|
|
184
185
|
<dd>
|
185
186
|
The number of bits in a quantum. The relationship between
|
186
|
-
QuantumDepth and
|
187
|
+
QuantumDepth and QuantumRange is summarized in this table.
|
187
188
|
|
188
189
|
<table summary="number of bits in a quantum" id="maxrgb">
|
189
|
-
|
190
190
|
<tr>
|
191
191
|
<th>QuantumDepth</th>
|
192
192
|
|
193
|
-
<th>
|
193
|
+
<th>QuantumRange</th>
|
194
194
|
</tr>
|
195
195
|
|
196
196
|
<tr>
|
@@ -321,9 +321,9 @@
|
|
321
321
|
files.</span> See <a href=
|
322
322
|
"imageattrs.html#colorspace">colorspace</a>.</p>
|
323
323
|
|
324
|
-
<p>Each version of ImageMagick
|
325
|
-
|
326
|
-
|
324
|
+
<p>Each version of ImageMagick defines a subset of the
|
325
|
+
colorspaces listed below. To list the subset supported by your
|
326
|
+
version, issue the command:</p>
|
327
327
|
<pre class="example">
|
328
328
|
ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
329
329
|
</pre>
|
@@ -378,9 +378,9 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
378
378
|
|
379
379
|
<dt>SRGBColorspace</dt>
|
380
380
|
|
381
|
-
<dd>Kodak PhotoCD sRGB. In
|
382
|
-
|
383
|
-
|
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
384
|
|
385
385
|
<dt>HSLColorspace</dt>
|
386
386
|
|
@@ -402,12 +402,6 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
402
402
|
industry.</p>
|
403
403
|
|
404
404
|
<dl>
|
405
|
-
<dt>CineonLogRGBColorspace</dt>
|
406
|
-
|
407
|
-
<dd>A logarithmic RGB space based on Kodak's Cineon log
|
408
|
-
definition. RGB data with Cineon Log scaling, 2.048 density
|
409
|
-
range.</dd>
|
410
|
-
|
411
405
|
<dt>Rec601LumaColorspace</dt>
|
412
406
|
|
413
407
|
<dd>Luma (Y) according to ITU-R 601</dd>
|
@@ -599,8 +593,12 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
599
593
|
|
600
594
|
<dt>ThresholdCompositeOp</dt>
|
601
595
|
|
596
|
+
<dd>?</dd>
|
597
|
+
|
602
598
|
<dt>NoCompositeOp</dt>
|
603
599
|
|
600
|
+
<dd>No composite operator has been specified.</dd>
|
601
|
+
|
604
602
|
<dt>DarkenCompositeOp</dt>
|
605
603
|
|
606
604
|
<dd>Replace target image pixels with darker pixels from the
|
@@ -644,6 +642,12 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
644
642
|
|
645
643
|
<dt>OverlayCompositeOp</dt>
|
646
644
|
|
645
|
+
<dd class="imquote">Multiplies or screens the colors, dependent
|
646
|
+
on the destination color. Source colors overlay the destination
|
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>
|
650
|
+
|
647
651
|
<dt>CopyCyanCompositeOp</dt>
|
648
652
|
|
649
653
|
<dd>Copy the cyan channel from the composite image to the
|
@@ -666,24 +670,54 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
666
670
|
|
667
671
|
<dt>DstAtopCompositeOp</dt>
|
668
672
|
|
673
|
+
<dd class="imquote">The part of the destination lying inside of
|
674
|
+
the source is composited over the source and replaces the
|
675
|
+
destination.</dd>
|
676
|
+
|
669
677
|
<dt>DstCompositeOp</dt>
|
670
678
|
|
679
|
+
<dd class="imquote">The destination is left untouched.</dd>
|
680
|
+
|
671
681
|
<dt>DstInCompositeOp</dt>
|
672
682
|
|
683
|
+
<dd class="imquote">The part of the destination lying inside of
|
684
|
+
the source replaces the destination.</dd>
|
685
|
+
|
673
686
|
<dt>DstOutCompositeOp</dt>
|
674
687
|
|
688
|
+
<dd class="imquote">The part of the destination lying outside
|
689
|
+
of the source replaces the destination.</dd>
|
690
|
+
|
675
691
|
<dt>DstOverCompositeOp</dt>
|
676
692
|
|
693
|
+
<dd class="imquote">The destination is composited over the
|
694
|
+
source and the result replaces the destination.</dd>
|
695
|
+
|
677
696
|
<dt>SrcAtopCompositeOp</dt>
|
678
697
|
|
698
|
+
<dd class="imquote">The part of the source lying inside of the
|
699
|
+
destination is composited onto the destination.</dd>
|
700
|
+
|
679
701
|
<dt>SrcCompositeOp</dt>
|
680
702
|
|
703
|
+
<dd class="imquote">The source is copied to the destination.
|
704
|
+
The destination is not used as input.</dd>
|
705
|
+
|
681
706
|
<dt>SrcInCompositeOp</dt>
|
682
707
|
|
708
|
+
<dd class="imquote">he part of the source lying inside of the
|
709
|
+
destination replaces the destination.</dd>
|
710
|
+
|
683
711
|
<dt>SrcOutCompositeOp</dt>
|
684
712
|
|
713
|
+
<dd class="imquote">The part of the source lying outside of the
|
714
|
+
destination replaces the destination.</dd>
|
715
|
+
|
685
716
|
<dt>SrcOverCompositeOp</dt>
|
686
717
|
|
718
|
+
<dd class="imquote">The source is composited over the
|
719
|
+
destination.</dd>
|
720
|
+
|
687
721
|
<dt>ColorDodgeCompositeOp</dt>
|
688
722
|
|
689
723
|
<dd class="imquote">Brightens the destination color to reflect
|
@@ -691,6 +725,11 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
691
725
|
|
692
726
|
<dt>ExclusionCompositeOp</dt>
|
693
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
|
+
|
694
733
|
<dt>HardLightCompositeOp</dt>
|
695
734
|
|
696
735
|
<dd class="imquote">Multiplies or screens the colors, dependent
|
@@ -715,6 +754,17 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
715
754
|
Painting with pure black or white produces a distinctly darker
|
716
755
|
or lighter area, but does not result in pure black or
|
717
756
|
white.</dd>
|
757
|
+
|
758
|
+
<dt>ChangeMaskCompositeOp</dt>
|
759
|
+
|
760
|
+
<dd class="imquote">Replace any destination pixel that is the
|
761
|
+
simular to the source images pixel (as defined by the current
|
762
|
+
fuzz factor), with transparency.</dd>
|
763
|
+
|
764
|
+
<dt>LinearLightCompositeOp</dt>
|
765
|
+
|
766
|
+
<dd class="imquote">Increase contrast slightly with an impact
|
767
|
+
on the foreground's tonal values.</dd>
|
718
768
|
</dl>
|
719
769
|
|
720
770
|
<h3 class="const" id="CompressionType">CompressionType</h3>
|
@@ -722,9 +772,9 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
722
772
|
<p><span class="imquote">Express the desired compression type
|
723
773
|
when encoding an image. Be aware that most image types only
|
724
774
|
support a sub-set of the available compression types. If the
|
725
|
-
compression type specified is
|
726
|
-
|
727
|
-
|
775
|
+
compression type specified is incompatable with the image,
|
776
|
+
ImageMagick selects a compression type compatable with the image
|
777
|
+
type.</span> See <a href=
|
728
778
|
"imageattrs.html#compression">compression</a>.</p>
|
729
779
|
|
730
780
|
<dl>
|
@@ -759,8 +809,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
759
809
|
|
760
810
|
<dt>JPEG2000Compression</dt>
|
761
811
|
|
762
|
-
<dd>JPEG2000 compression for compressed PDF images
|
763
|
-
in ImageMagick 6.2.2.)</dd>
|
812
|
+
<dd>JPEG2000 compression for compressed PDF images.</dd>
|
764
813
|
|
765
814
|
<dt>LosslessJPEGCompression</dt>
|
766
815
|
|
@@ -847,8 +896,8 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
847
896
|
|
848
897
|
<p><span class="imquote">Used to adjust the filter algorithm used
|
849
898
|
when resizing images. Different filters experience varying
|
850
|
-
degrees of success with various images and can take
|
851
|
-
different amounts of processing time.
|
899
|
+
degrees of success with various images and can take sigificantly
|
900
|
+
different amounts of processing time. ImageMagick uses the
|
852
901
|
LanczosFilter by default since this filter has been shown to
|
853
902
|
provide the best results for most images in a reasonable amount
|
854
903
|
of time. Other filter types (e.g. TriangleFilter) may execute
|
@@ -889,6 +938,18 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
889
938
|
<dt>BesselFilter</dt>
|
890
939
|
|
891
940
|
<dt>SincFilter</dt>
|
941
|
+
|
942
|
+
<dt>KaiserFilter</dt>
|
943
|
+
|
944
|
+
<dt>WelshFilter</dt>
|
945
|
+
|
946
|
+
<dt>ParzenFilter</dt>
|
947
|
+
|
948
|
+
<dt>LagrangianFilter</dt>
|
949
|
+
|
950
|
+
<dt>Bohman</dt>
|
951
|
+
|
952
|
+
<dt>Bartlett</dt>
|
892
953
|
</dl>
|
893
954
|
|
894
955
|
<h3 class="const" id="GravityType">GravityType</h3>
|
@@ -913,7 +974,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
913
974
|
|
914
975
|
<dt>NorthGravity</dt>
|
915
976
|
|
916
|
-
<dd class="imquote">
|
977
|
+
<dd class="imquote">Postiion object at top-center of
|
917
978
|
region</dd>
|
918
979
|
|
919
980
|
<dt>NorthEastGravity</dt>
|
@@ -1036,6 +1097,15 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1036
1097
|
<dd class="imquote">Similar to plane interlacing except that
|
1037
1098
|
the different planes are saved to individual files (e.g.
|
1038
1099
|
image.R, image.G, and image.B)</dd>
|
1100
|
+
|
1101
|
+
<dt>GIFInterlace</dt>
|
1102
|
+
|
1103
|
+
<dt>JPEGInterlace</dt>
|
1104
|
+
|
1105
|
+
<dt>PNGInterlace</dt>
|
1106
|
+
|
1107
|
+
<dd>See the ImageMagick documentation for the -interlace
|
1108
|
+
option.</dd>
|
1039
1109
|
</dl>
|
1040
1110
|
|
1041
1111
|
<h3 class="const" id="InterpolatePixelMethod">
|
@@ -1058,6 +1128,8 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1058
1128
|
<dt>MeshInterpolatePixel</dt>
|
1059
1129
|
|
1060
1130
|
<dt>NearestNeighborInterpolatePixel</dt>
|
1131
|
+
|
1132
|
+
<dt>SplineInterpolatePixel</dt>
|
1061
1133
|
</dl>
|
1062
1134
|
|
1063
1135
|
<p>For FilterInterpolatePixel, specify the filter with the
|
@@ -1101,6 +1173,8 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1101
1173
|
<dt>LaplacianNoise</dt>
|
1102
1174
|
|
1103
1175
|
<dt>PoissonNoise</dt>
|
1176
|
+
|
1177
|
+
<dt>RandomNoise</dt>
|
1104
1178
|
</dl>
|
1105
1179
|
|
1106
1180
|
<h3 class="const" id="Opacity">Opacity</h3>
|
@@ -1242,7 +1316,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1242
1316
|
<dt>PixelsPerInchResolution</dt>
|
1243
1317
|
|
1244
1318
|
<dd class="imquote">Density specifications are specified in
|
1245
|
-
units of pixels per inch (
|
1319
|
+
units of pixels per inch (english units).</dd>
|
1246
1320
|
|
1247
1321
|
<dt>PixelsPerCentimeterResolution</dt>
|
1248
1322
|
|
@@ -1313,8 +1387,8 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1313
1387
|
|
1314
1388
|
<dt>QuantumPixel</dt>
|
1315
1389
|
|
1316
|
-
<dd>corresponds to the Quantum type used by
|
1317
|
-
|
1390
|
+
<dd>corresponds to the Quantum type used by ImageMagick, range
|
1391
|
+
0-QuantumRange.</dd>
|
1318
1392
|
</dl>
|
1319
1393
|
|
1320
1394
|
<h3 class="const" id="StyleType">StyleType</h3>
|
@@ -1340,7 +1414,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1340
1414
|
<dl>
|
1341
1415
|
<dt>AnyWeight</dt>
|
1342
1416
|
|
1343
|
-
<dd>No weight
|
1417
|
+
<dd>No weight specfied.</dd>
|
1344
1418
|
|
1345
1419
|
<dt>NormalWeight</dt>
|
1346
1420
|
|
@@ -1359,7 +1433,7 @@ ruby -rRMagick -e"Magick::ColorspaceType.values {|cs| puts cs}"
|
|
1359
1433
|
<dd>Decreases weight by 100</dd>
|
1360
1434
|
</dl>
|
1361
1435
|
|
1362
|
-
<p class="spacer"
|
1436
|
+
<p class="spacer"></p>
|
1363
1437
|
|
1364
1438
|
<div class="nav">
|
1365
1439
|
« <a href="info.html">Prev</a> | <a href=
|
data/doc/draw.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: class Draw</title>
|
10
10
|
<meta http-equiv="Content-Type" content=
|
11
11
|
"text/html; charset=us-ascii" />
|
12
12
|
<meta name="GENERATOR" content="Quanta Plus" />
|
@@ -25,7 +25,7 @@
|
|
25
25
|
</head>
|
26
26
|
|
27
27
|
<body>
|
28
|
-
<h6 id="header">RMagick
|
28
|
+
<h6 id="header">RMagick 2.0.0 User's Guide and Reference</h6>
|
29
29
|
|
30
30
|
<div class="nav">
|
31
31
|
« <a href="image3.html">Prev</a> | <a href=
|
@@ -200,6 +200,8 @@
|
|
200
200
|
<li><a href="#encoding_eq">encoding</a></li>
|
201
201
|
|
202
202
|
<li><a href="#fill_eq">fill</a></li>
|
203
|
+
|
204
|
+
<li><a href="#fill_pattern_eq">fill_pattern</a></li>
|
203
205
|
</ul>
|
204
206
|
</div>
|
205
207
|
|
@@ -216,17 +218,19 @@
|
|
216
218
|
<li><a href="#font_weight_eq">font_weight</a></li>
|
217
219
|
|
218
220
|
<li><a href="#gravity_eq">gravity</a></li>
|
221
|
+
|
222
|
+
<li><a href="#pointsize_eq">pointsize</a></li>
|
219
223
|
</ul>
|
220
224
|
</div>
|
221
225
|
|
222
226
|
<div class="toccol">
|
223
227
|
<ul>
|
224
|
-
<li><a href="#pointsize_eq">pointsize</a></li>
|
225
|
-
|
226
228
|
<li><a href="#rotation_eq">rotation</a></li>
|
227
229
|
|
228
230
|
<li><a href="#stroke_eq">stroke</a></li>
|
229
231
|
|
232
|
+
<li><a href="#stroke_pattern_eq">stroke_pattern</a></li>
|
233
|
+
|
230
234
|
<li><a href="#stroke_width_eq">stroke_width</a></li>
|
231
235
|
|
232
236
|
<li><a href="#text_antialias_eq">text_antialias</a></li>
|
@@ -534,7 +538,7 @@ title.annotate(montage, 0,0,0,40, 'Named Colors') {
|
|
534
538
|
<h4>Description</h4>
|
535
539
|
|
536
540
|
<p>Same as <a href="#dup">dup</a> except the frozen state of
|
537
|
-
the original is
|
541
|
+
the original is propogated to the copy.</p>
|
538
542
|
|
539
543
|
<h4>Returns</h4>
|
540
544
|
|
@@ -665,7 +669,7 @@ title.annotate(montage, 0,0,0,40, 'Named Colors') {
|
|
665
669
|
<dt>image <em>(optional)</em></dt>
|
666
670
|
|
667
671
|
<dd>The image on which the string will be rendered.
|
668
|
-
|
672
|
+
ImageMagick uses the attributes of the image (font name,
|
669
673
|
pointsize, etc.) to compute the metrics. If this argument is
|
670
674
|
omitted, <code>get_type_metrics</code> substitutes a dummy
|
671
675
|
image with default attributes. The <span class=
|
@@ -756,8 +760,7 @@ title.annotate(montage, 0,0,0,40, 'Named Colors') {
|
|
756
760
|
|
757
761
|
<h4>Magick API</h4>
|
758
762
|
|
759
|
-
<p>GetTypeMetrics, GetMultilineTypeMetrics
|
760
|
-
ImageMagick 6.1.5)</p>
|
763
|
+
<p>GetTypeMetrics, GetMultilineTypeMetrics</p>
|
761
764
|
</div>
|
762
765
|
|
763
766
|
<div class="sig">
|
@@ -890,14 +893,6 @@ draw.inspect »
|
|
890
893
|
|
891
894
|
<h4>See also</h4><a href="#ellipse">ellipse</a>, <a href=
|
892
895
|
"#path">the SVG elliptical arc commands (A and a)</a>
|
893
|
-
|
894
|
-
<h4>Note</h4>
|
895
|
-
|
896
|
-
<p>The <code>arc</code> method is broken in all releases of
|
897
|
-
ImageMagick prior to 6.0.0, and all releases of GraphicsMagick
|
898
|
-
prior to 1.1. If you see a diagonal line here instead of an
|
899
|
-
arc, it's broken. Either upgrade to the newest version or use
|
900
|
-
one of the other methods listed above.</p>
|
901
896
|
</div>
|
902
897
|
|
903
898
|
<div class="sig">
|
@@ -1284,9 +1279,9 @@ draw.decorate(Magick::LineThroughDecoration)
|
|
1284
1279
|
<a href="#clip_path">clip-path</a> method, anything drawn on
|
1285
1280
|
the image inside the clip-path will appear. Anything drawn
|
1286
1281
|
outside the clip-path will be hidden. (See <a href=
|
1287
|
-
"#clip_rule">clip_rule</a> for a definition of how
|
1288
|
-
|
1289
|
-
|
1282
|
+
"#clip_rule">clip_rule</a> for a definition of how ImageMagick
|
1283
|
+
decides what is "inside" and what is "outside" of the
|
1284
|
+
clip-path.)</p>
|
1290
1285
|
|
1291
1286
|
<h4>Arguments</h4>
|
1292
1287
|
|
@@ -1366,7 +1361,7 @@ draw.decorate(Magick::LineThroughDecoration)
|
|
1366
1361
|
|
1367
1362
|
<h4>Arguments</h4>
|
1368
1363
|
|
1369
|
-
<p>See the
|
1364
|
+
<p>See the ImageMagick documentation for the
|
1370
1365
|
<code>-encoding</code> option to the <code>mogrify</code>
|
1371
1366
|
command</p>
|
1372
1367
|
|
@@ -2050,7 +2045,7 @@ draw.decorate(Magick::LineThroughDecoration)
|
|
2050
2045
|
|
2051
2046
|
<p><em>Note:</em> The <code>push</code> and <code>pop</code>
|
2052
2047
|
methods are probably not as useful in RMagick as they are in C
|
2053
|
-
language
|
2048
|
+
language ImageMagick programs, since it is easy to create
|
2054
2049
|
separate draw objects, each with its own set of properties and
|
2055
2050
|
primitives.</p>
|
2056
2051
|
|
@@ -2214,7 +2209,7 @@ draw.decorate(Magick::LineThroughDecoration)
|
|
2214
2209
|
<div class="desc">
|
2215
2210
|
<h4>Description</h4>
|
2216
2211
|
|
2217
|
-
<p>Define a skew
|
2212
|
+
<p>Define a skew tranformation along the x-axis.</p>
|
2218
2213
|
|
2219
2214
|
<h4>Arguments</h4>
|
2220
2215
|
|
@@ -2246,7 +2241,7 @@ draw.decorate(Magick::LineThroughDecoration)
|
|
2246
2241
|
<div class="desc">
|
2247
2242
|
<h4>Description</h4>
|
2248
2243
|
|
2249
|
-
<p>Define a skew
|
2244
|
+
<p>Define a skew tranformation along the y-axis.</p>
|
2250
2245
|
|
2251
2246
|
<h4>Arguments</h4>
|
2252
2247
|
|
@@ -2556,7 +2551,7 @@ draw.stroke_opacity('40%')
|
|
2556
2551
|
<p>Generally it is a good idea to surround the text string with
|
2557
2552
|
quotes (""), apostrophes (''), or braces ({}). If the text
|
2558
2553
|
string starts with a digit or contains an embedded blank,
|
2559
|
-
quote, or apostrophe, you must do this.
|
2554
|
+
quote, or apostrophe, you must do this. ImageMagick removes
|
2560
2555
|
these characters before drawing the text. You can also escape a
|
2561
2556
|
blank, quote, or apostrophe by preceding it with a backslash
|
2562
2557
|
("\"). To include a backslash in the text, use two consecutive
|
@@ -2769,10 +2764,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2769
2764
|
<h4>Argument</h4>
|
2770
2765
|
|
2771
2766
|
<p>An <a href="struct.html#AffineMatrix">AffineMatrix</a>.</p>
|
2772
|
-
|
2773
|
-
<h4>Returns</h4>
|
2774
|
-
|
2775
|
-
<p>self</p>
|
2776
2767
|
</div>
|
2777
2768
|
|
2778
2769
|
<div class="sig">
|
@@ -2792,10 +2783,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2792
2783
|
|
2793
2784
|
<p>A <a href="constants.html#AlignType">AlignType</a>
|
2794
2785
|
constant.</p>
|
2795
|
-
|
2796
|
-
<h4>Returns</h4>
|
2797
|
-
|
2798
|
-
<p>self</p>
|
2799
2786
|
</div>
|
2800
2787
|
|
2801
2788
|
<div class="sig">
|
@@ -2815,10 +2802,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2815
2802
|
|
2816
2803
|
<p>A <a href="constants.html#DecorationType">DecorationType</a>
|
2817
2804
|
constant.</p>
|
2818
|
-
|
2819
|
-
<h4>Returns</h4>
|
2820
|
-
|
2821
|
-
<p>self</p>
|
2822
2805
|
</div>
|
2823
2806
|
|
2824
2807
|
<div class="sig">
|
@@ -2832,10 +2815,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2832
2815
|
|
2833
2816
|
<p>The text density in the x and y directions. The default is
|
2834
2817
|
"72x72".</p>
|
2835
|
-
|
2836
|
-
<h4>Returns</h4>
|
2837
|
-
|
2838
|
-
<p>self</p>
|
2839
2818
|
</div>
|
2840
2819
|
|
2841
2820
|
<div class="sig">
|
@@ -2852,13 +2831,9 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2852
2831
|
|
2853
2832
|
<h4>Argument</h4>
|
2854
2833
|
|
2855
|
-
<p>See the
|
2834
|
+
<p>See the ImageMagick documentation for the
|
2856
2835
|
<code>-encoding</code> option to the <code>mogrify</code>
|
2857
2836
|
command.</p>
|
2858
|
-
|
2859
|
-
<h4>Returns</h4>
|
2860
|
-
|
2861
|
-
<p>self</p>
|
2862
2837
|
</div>
|
2863
2838
|
|
2864
2839
|
<div class="sig">
|
@@ -2875,10 +2850,28 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2875
2850
|
|
2876
2851
|
<p>May be a <a href="imusage.html#color_names">color name</a>
|
2877
2852
|
or a <a href="struct.html#Pixel">Pixel</a> object.</p>
|
2853
|
+
</div>
|
2878
2854
|
|
2879
|
-
|
2855
|
+
<div class="sig">
|
2856
|
+
<h3 id="fill_pattern_eq">fill_pattern=</h3>
|
2880
2857
|
|
2881
|
-
<p>
|
2858
|
+
<p><span class="arg">draw</span>.fill_pattern =
|
2859
|
+
<em>anImage</em></p>
|
2860
|
+
</div>
|
2861
|
+
|
2862
|
+
<div class="desc">
|
2863
|
+
<h4>Description</h4>Specify an image to use for the fill.
|
2864
|
+
|
2865
|
+
<h4>Argument</h4>
|
2866
|
+
|
2867
|
+
<p>An image.</p>
|
2868
|
+
|
2869
|
+
<h4>Example</h4>
|
2870
|
+
|
2871
|
+
<p><a href="javascript:popup('fill_pattern.rb.html')" title=
|
2872
|
+
"Click to see the example script"><img src=
|
2873
|
+
"ex/fill_pattern.gif" alt=
|
2874
|
+
"fill_pattern and stroke_pattern example" /></a></p>
|
2882
2875
|
</div>
|
2883
2876
|
|
2884
2877
|
<div class="sig">
|
@@ -2892,10 +2885,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2892
2885
|
|
2893
2886
|
<p>The font name. The default is "Helvetica". See <a href=
|
2894
2887
|
"#font">font</a> for more information about font names.</p>
|
2895
|
-
|
2896
|
-
<h4>Returns</h4>
|
2897
|
-
|
2898
|
-
<p>self</p>
|
2899
2888
|
</div>
|
2900
2889
|
|
2901
2890
|
<div class="sig">
|
@@ -2910,10 +2899,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2910
2899
|
|
2911
2900
|
<p>The font family name. For example, "arial" or
|
2912
2901
|
"helvetica".</p>
|
2913
|
-
|
2914
|
-
<h4>Returns</h4>
|
2915
|
-
|
2916
|
-
<p>self</p>
|
2917
2902
|
</div>
|
2918
2903
|
|
2919
2904
|
<div class="sig">
|
@@ -2930,10 +2915,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2930
2915
|
|
2931
2916
|
<h4>Argument</h4>A <a href=
|
2932
2917
|
"constants.html#StretchType">StretchType</a> constant.
|
2933
|
-
|
2934
|
-
<h4>Returns</h4>
|
2935
|
-
|
2936
|
-
<p>self</p>
|
2937
2918
|
</div>
|
2938
2919
|
|
2939
2920
|
<div class="sig">
|
@@ -2952,10 +2933,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2952
2933
|
|
2953
2934
|
<p>A <a href="constants.html#StyleType">StyleType</a>
|
2954
2935
|
constant.</p>
|
2955
|
-
|
2956
|
-
<h4>Returns</h4>
|
2957
|
-
|
2958
|
-
<p>self</p>
|
2959
2936
|
</div>
|
2960
2937
|
|
2961
2938
|
<div class="sig">
|
@@ -2975,10 +2952,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2975
2952
|
<p>A <a href="constants.html#WeightType">WeightType</a>
|
2976
2953
|
constant or one of the numbers 100, 200, 300, 400, 500, 600,
|
2977
2954
|
700, 800, or 900.</p>
|
2978
|
-
|
2979
|
-
<h4>Returns</h4>
|
2980
|
-
|
2981
|
-
<p>self</p>
|
2982
2955
|
</div>
|
2983
2956
|
|
2984
2957
|
<div class="sig">
|
@@ -2998,10 +2971,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
2998
2971
|
|
2999
2972
|
<p>A <a href="constants.html#GravityType">GravityType</a>
|
3000
2973
|
constant.</p>
|
3001
|
-
|
3002
|
-
<h4>Returns</h4>
|
3003
|
-
|
3004
|
-
<p>self</p>
|
3005
2974
|
</div>
|
3006
2975
|
|
3007
2976
|
<div class="sig">
|
@@ -3015,12 +2984,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
3015
2984
|
<h4>Description</h4>
|
3016
2985
|
|
3017
2986
|
<p>The font size in points. The default is 12.</p>
|
3018
|
-
|
3019
|
-
<h4>Returns</h4>
|
3020
|
-
|
3021
|
-
<p>self</p>
|
3022
|
-
|
3023
|
-
<h4>Example</h4>
|
3024
2987
|
</div>
|
3025
2988
|
|
3026
2989
|
<div class="sig">
|
@@ -3038,10 +3001,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
3038
3001
|
<h4>Arguments</h4>
|
3039
3002
|
|
3040
3003
|
<p>The amount of rotation in degrees.</p>
|
3041
|
-
|
3042
|
-
<h4>Returns</h4>
|
3043
|
-
|
3044
|
-
<p>self</p>
|
3045
3004
|
</div>
|
3046
3005
|
|
3047
3006
|
<div class="sig">
|
@@ -3059,10 +3018,25 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
3059
3018
|
|
3060
3019
|
<h4>Arguments</h4>A <a href="imusage.html#color_names">color
|
3061
3020
|
name</a> or <a href="struct.html#Pixel">Pixel</a> object.
|
3021
|
+
</div>
|
3062
3022
|
|
3063
|
-
|
3023
|
+
<div class="sig">
|
3024
|
+
<h3 id="stroke_pattern_eq">stroke_pattern=</h3>
|
3064
3025
|
|
3065
|
-
<p>
|
3026
|
+
<p><span class="arg">draw</span>.stroke_pattern =
|
3027
|
+
<em>anImage</em></p>
|
3028
|
+
</div>
|
3029
|
+
|
3030
|
+
<div class="desc">
|
3031
|
+
<h4>Description</h4>Specify an image to use for the stroke.
|
3032
|
+
|
3033
|
+
<h4>Argument</h4>
|
3034
|
+
|
3035
|
+
<p>An image.</p>
|
3036
|
+
|
3037
|
+
<h4>Example</h4>
|
3038
|
+
|
3039
|
+
<p>See <a href="#fill_pattern_eq">fill_pattern</a></p>
|
3066
3040
|
</div>
|
3067
3041
|
|
3068
3042
|
<div class="sig">
|
@@ -3076,10 +3050,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
3076
3050
|
<h4>Description</h4>
|
3077
3051
|
|
3078
3052
|
<p>The stroke width in pixels. The default is 1.</p>
|
3079
|
-
|
3080
|
-
<h4>Returns</h4>
|
3081
|
-
|
3082
|
-
<p>self</p>
|
3083
3053
|
</div>
|
3084
3054
|
|
3085
3055
|
<div class="sig">
|
@@ -3094,10 +3064,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
3094
3064
|
|
3095
3065
|
<p>Whether the text is antialiased or not. The default is
|
3096
3066
|
<code>true</code>.</p>
|
3097
|
-
|
3098
|
-
<h4>Returns</h4>
|
3099
|
-
|
3100
|
-
<p>self</p>
|
3101
3067
|
</div>
|
3102
3068
|
|
3103
3069
|
<div class="sig">
|
@@ -3114,10 +3080,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
3114
3080
|
<h4>Arguments</h4>
|
3115
3081
|
|
3116
3082
|
<p>An image</p>
|
3117
|
-
|
3118
|
-
<h4>Returns</h4>
|
3119
|
-
|
3120
|
-
<p>self</p>
|
3121
3083
|
</div>
|
3122
3084
|
|
3123
3085
|
<div class="sig">
|
@@ -3135,10 +3097,6 @@ gc.text(10,10, %q/{"What's up?"}/) » "What's up?"
|
|
3135
3097
|
|
3136
3098
|
<h4>Arguments</h4>A <a href="imusage.html#color_names">color
|
3137
3099
|
name</a> or a <a href="struct.html#Pixel">Pixel</a> object.
|
3138
|
-
|
3139
|
-
<h4>Returns</h4>
|
3140
|
-
|
3141
|
-
<p>self</p>
|
3142
3100
|
</div>
|
3143
3101
|
|
3144
3102
|
<p class="spacer"> </p>
|