rmagick 1.7.4 → 1.8.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.

Files changed (130) hide show
  1. data/ChangeLog +10 -2
  2. data/README.html +284 -290
  3. data/README.txt +298 -307
  4. data/configure +180 -11
  5. data/configure.ac +18 -2
  6. data/doc/comtasks.html +1 -1
  7. data/doc/constants.html +15 -10
  8. data/doc/css/ref.css +67 -0
  9. data/doc/draw.html +1 -1
  10. data/doc/ex/InitialCoords.rb +24 -0
  11. data/doc/ex/NewCoordSys.rb +33 -0
  12. data/doc/ex/OrigCoordSys.rb +19 -0
  13. data/doc/ex/PreserveAspectRatio.rb +206 -0
  14. data/doc/ex/RotateScale.rb +38 -0
  15. data/doc/ex/Skew.rb +39 -0
  16. data/doc/ex/Use01.rb +17 -0
  17. data/doc/ex/Use02.rb +22 -0
  18. data/doc/ex/Use03.rb +17 -0
  19. data/doc/ex/ViewBox.rb +34 -0
  20. data/doc/ex/arcs01.rb +29 -0
  21. data/doc/ex/arcs02.rb +62 -0
  22. data/doc/ex/baseline_shift01.rb +19 -0
  23. data/doc/ex/bounding_box.rb +31 -37
  24. data/doc/ex/circle01.rb +18 -0
  25. data/doc/ex/cubic01.rb +46 -0
  26. data/doc/ex/cubic02.rb +95 -0
  27. data/doc/ex/drop_shadow.rb +1 -1
  28. data/doc/ex/ellipse01.rb +23 -0
  29. data/doc/ex/evenodd.rb +44 -0
  30. data/doc/ex/font_styles.rb +29 -0
  31. data/doc/ex/group.rb +27 -0
  32. data/doc/ex/image.rb +47 -0
  33. data/doc/ex/images/big-duck.gif +0 -0
  34. data/doc/ex/images/duck.gif +0 -0
  35. data/doc/ex/images/duck0.gif +0 -0
  36. data/doc/ex/images/duck1.gif +0 -0
  37. data/doc/ex/images/duck10.gif +0 -0
  38. data/doc/ex/images/duck11.gif +0 -0
  39. data/doc/ex/images/duck12.gif +0 -0
  40. data/doc/ex/images/duck13.gif +0 -0
  41. data/doc/ex/images/duck14.gif +0 -0
  42. data/doc/ex/images/duck15.gif +0 -0
  43. data/doc/ex/images/duck2.gif +0 -0
  44. data/doc/ex/images/duck3.gif +0 -0
  45. data/doc/ex/images/duck4.gif +0 -0
  46. data/doc/ex/images/duck5.gif +0 -0
  47. data/doc/ex/images/duck6.gif +0 -0
  48. data/doc/ex/images/duck7.gif +0 -0
  49. data/doc/ex/images/duck8.gif +0 -0
  50. data/doc/ex/images/duck9.gif +0 -0
  51. data/doc/ex/line01.rb +24 -0
  52. data/doc/ex/nested_rvg.rb +22 -0
  53. data/doc/ex/nonzero.rb +44 -0
  54. data/doc/ex/polygon01.rb +24 -0
  55. data/doc/ex/polyline01.rb +24 -0
  56. data/doc/ex/quad01.rb +37 -0
  57. data/doc/ex/rect01.rb +16 -0
  58. data/doc/ex/rect02.rb +23 -0
  59. data/doc/ex/rvg_clippath.rb +15 -0
  60. data/doc/ex/rvg_linecap.rb +44 -0
  61. data/doc/ex/rvg_linejoin.rb +42 -0
  62. data/doc/ex/rvg_opacity.rb +20 -0
  63. data/doc/ex/rvg_pattern.rb +27 -0
  64. data/doc/ex/rvg_stroke_dasharray.rb +13 -0
  65. data/doc/ex/sepiatone.rb +15 -0
  66. data/doc/ex/shadow.rb +37 -0
  67. data/doc/ex/smile.rb +9 -9
  68. data/doc/ex/stroke_fill.rb +12 -0
  69. data/doc/ex/text01.rb +18 -0
  70. data/doc/ex/text_styles.rb +22 -0
  71. data/doc/ex/texture_fill_to_border.rb +3 -3
  72. data/doc/ex/texture_floodfill.rb +3 -2
  73. data/doc/ex/tref01.rb +26 -0
  74. data/doc/ex/triangle01.rb +17 -0
  75. data/doc/ex/tspan01.rb +19 -0
  76. data/doc/ex/tspan02.rb +20 -0
  77. data/doc/ex/tspan03.rb +22 -0
  78. data/doc/ex/writing_mode01.rb +28 -0
  79. data/doc/ex/writing_mode02.rb +27 -0
  80. data/doc/ilist.html +1 -1
  81. data/doc/image1.html +66 -30
  82. data/doc/image2.html +1 -1
  83. data/doc/image3.html +274 -49
  84. data/doc/imageattrs.html +87 -10
  85. data/doc/imusage.html +1 -1
  86. data/doc/index.html +80 -39
  87. data/doc/info.html +149 -13
  88. data/doc/magick.html +1 -1
  89. data/doc/rvg.html +890 -0
  90. data/doc/rvgclip.html +249 -0
  91. data/doc/rvggroup.html +305 -0
  92. data/doc/rvgimage.html +288 -0
  93. data/doc/rvgpattern.html +456 -0
  94. data/doc/rvgshape.html +376 -0
  95. data/doc/rvgstyle.html +269 -0
  96. data/doc/rvgtext.html +464 -0
  97. data/doc/rvgtspan.html +237 -0
  98. data/doc/rvgtut.html +512 -0
  99. data/doc/rvguse.html +145 -0
  100. data/doc/rvgxform.html +294 -0
  101. data/doc/struct.html +9 -71
  102. data/doc/usage.html +22 -7
  103. data/ext/RMagick/MANIFEST +94 -2
  104. data/ext/RMagick/rmagick.h +10 -4
  105. data/ext/RMagick/rmagick_config.h.in +8 -2
  106. data/ext/RMagick/rmdraw.c +2 -2
  107. data/ext/RMagick/rmfill.c +2 -2
  108. data/ext/RMagick/rmilist.c +3 -3
  109. data/ext/RMagick/rmimage.c +152 -5
  110. data/ext/RMagick/rminfo.c +208 -2
  111. data/ext/RMagick/rmmain.c +14 -5
  112. data/ext/RMagick/rmutil.c +83 -22
  113. data/lib/RMagick.rb +2 -2
  114. data/lib/rvg/clippath.rb +46 -0
  115. data/lib/rvg/container.rb +129 -0
  116. data/lib/rvg/deep_equal.rb +54 -0
  117. data/lib/rvg/describable.rb +51 -0
  118. data/lib/rvg/embellishable.rb +395 -0
  119. data/lib/rvg/misc.rb +729 -0
  120. data/lib/rvg/paint.rb +48 -0
  121. data/lib/rvg/pathdata.rb +129 -0
  122. data/lib/rvg/rvg.rb +279 -0
  123. data/lib/rvg/stretchable.rb +150 -0
  124. data/lib/rvg/stylable.rb +116 -0
  125. data/lib/rvg/text.rb +185 -0
  126. data/lib/rvg/transformable.rb +131 -0
  127. data/lib/rvg/units.rb +64 -0
  128. data/rmagick.gemspec +1 -1
  129. data/uninstall.rb +3 -2
  130. metadata +96 -3
data/ChangeLog CHANGED
@@ -1,11 +1,19 @@
1
+ RMagick 1.8.0
2
+ o Added Image#shadow (ImageMagick 6.1.7)
3
+ o Added Image::Info#undefine, #[], #[]=
4
+ o Added sigmoidal_contrast_channel, sepiatone to Image class (ImageMagick 6.2.1)
5
+ o Added JPEG2000Compression constant (ImageMagick 6.2.2)
6
+ o Incorporated RVG classes
7
+ o Added RVG documentation, examples, updated installer
8
+ o Tested with ImageMagick 6.2.2-0, latest GraphicsMagick 1.2
9
+
1
10
  RMagick 1.7.4
2
11
  o Fix bug #1727
3
12
  o Fix affine_transform.rb
4
13
  o Tested with ImageMagick 6.2.1
5
14
 
6
15
  RMagick 1.7.3
7
- o Fix bug #1553
8
-
16
+ o Fix bug #1553, a build issue with ImageMagick 6.0.x
9
17
 
10
18
  RMagick 1.7.2
11
19
  o Fix bugs #1308, #1310, #1314, #1533
data/README.html CHANGED
@@ -1,122 +1,108 @@
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 1.7.4 README</title>
4
+ <title>RMagick 1.8.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
- <p>RMagick 1.7.4</p>
10
-
11
- <pre><code>README
12
-
13
-
14
- 04/02/05
15
-
16
-
17
- Table of Contents
18
-
19
- * Introduction &lt;#introduction&gt;
20
- * Contact information &lt;#contact_information&gt;
21
- * Prerequisites &lt;#prerequisites&gt;
22
- * Tips for installing and configuring ImageMagick and GraphicsMagick
23
- &lt;#tips&gt;
24
- * Installing RMagick &lt;#installing_rmagick&gt;
25
- o Configuration options &lt;#configuration_options&gt;
26
- o Running the configure and make scripts &lt;#running&gt;
27
- * Things that can go wrong &lt;#things_that_can_go_wrong&gt;
28
- * Upgrading &lt;#upgrading&gt;
29
- * Uninstalling &lt;#uninstalling&gt;
30
- * More samples &lt;#more_samples&gt;
31
- * Undocumented features &lt;#undocumented_features&gt;
32
- * Known issues &lt;#known_issues&gt;
33
- * Reporting bugs &lt;#reporting_bugs&gt;
34
- * Credits &lt;#credits&gt;
35
- * License &lt;#license&gt;
36
-
37
-
38
- Introduction
39
- </code></pre>
9
+ <h1>RMagick 1.8.0 README</h1>
10
+
11
+ <h2>04/30/05</h2>
12
+
13
+ <h2>Table Of Contents</h2>
14
+
15
+ <ul>
16
+ <li><a href="#intro">Introduction</a></li>
17
+ <li><a href="#contact">Contact Information</a></li>
18
+ <li><a href="#prereq">Prerequisites</a></li>
19
+ <li><a href="#tips">Tips for installing and configuring ImageMagick and GraphicsMagick</a></li>
20
+ <li><a href="#install">Installing RMagick</a>
21
+ <ul>
22
+ <li><a href="#options">Configuration options</a></li>
23
+ <li><a href="#scripts">Running the configure and make scripts</a></li>
24
+ </ul></li>
25
+ <li><a href="#uhoh">Things that can go wrong</a></li>
26
+ <li><a href="#upgrade">Upgrading</a></li>
27
+ <li><a href="#uninstall">Uninstalling</a></li>
28
+ <li><a href="#samples">More samples</a></li>
29
+ <li><a href="#undoc">Undocumented features</a></li>
30
+ <li><a href="#issues">Known issues</a></li>
31
+ <li><a href="#bugs">Reporting bugs</a></li>
32
+ <li><a href="#credits">Credits</a></li>
33
+ <li><a href="#license">License</a></li>
34
+ </ul>
35
+
36
+ <h2 id="intro">Introduction</h2>
40
37
 
41
38
  <p>RMagick is an interface between the Ruby programming language and the
42
39
  ImageMagick and GraphicsMagick image processing libraries.</p>
43
40
 
44
- <pre><code>Contact Information
45
- </code></pre>
41
+ <h2 id="contact">Contact Information</h2>
46
42
 
47
- <p><em>Author:</em> Tim Hunter
48
- <em>Email:</em> rmagick@rubyforge.org <mailto:rmagick@rubyforge.org>
49
- <em>RubyForge:</em> RMagick <a href="http://rubyforge.org/projects/rmagick">http://rubyforge.org/projects/rmagick</a></p>
43
+ <p><strong>Author:</strong> Tim Hunter</p>
50
44
 
51
- <pre><code>Prerequisites
52
- </code></pre>
45
+ <p><strong>Email:</strong> <a href="&#109;&#x61;&#105;&#x6C;&#116;&#x6F;:&#114;&#x6D;&#x61;g&#x69;&#x63;&#107;&#064;&#x72;&#117;&#098;&#x79;&#102;&#111;&#x72;&#103;e&#x2E;&#x6F;r&#x67;">&#114;&#x6D;&#x61;g&#x69;&#x63;&#107;&#064;&#x72;&#117;&#098;&#x79;&#102;&#111;&#x72;&#103;e&#x2E;&#x6F;r&#x67;</a></p>
53
46
 
54
- <p><em>O/S</em>
55
- Linux, Sun Solaris, Cygwin, FreeBSD, MS Windows 98 and later.
56
- <em>Ruby</em>
57
- Ruby 1.6.7 or later. You can get Ruby from www.ruby-lang.org
58
- <a href="http://www.ruby-lang.org">http://www.ruby-lang.org</a></p>
47
+ <p><strong>RubyForge:</strong> <a href="http://rubyforge.org/projects/rmagick/">http://rubyforge.org/projects/rmagick/</a></p>
59
48
 
60
- <p>One of</p>
49
+ <h2 id="prereq">Prerequisites</h2>
61
50
 
62
- <p><em>ImageMagick</em>
63
- ImageMagick 6.0.0 or later. You can get ImageMagick from
64
- www.imagemagick.org <a href="http://www.imagemagick.org">http://www.imagemagick.org</a>.
65
- <em>GraphicsMagick</em>
66
- GraphicsMagick is a friendly fork of ImageMagick 5.5.1. You can get
67
- GraphicsMagick from www.graphicsmagick.org
68
- <a href="http://www.graphicsmagick.org">http://www.graphicsmagick.org</a>.</p>
51
+ <p><strong>O/S:</strong> Linux, Sun Solaris, Cygwin, FreeBSD, MS Windows 98 and later.</p>
69
52
 
70
- <p>You only need one of ImageMagick or GraphicsMagick. RMagick works
71
- equally well with both. Some RMagick methods may not be supported in one
72
- or the other library.</p>
53
+ <p><strong>Ruby</strong> 1.6.7 or later. You can get Ruby from <a href="http://www.ruby-lang.org">http://www.ruby-lang.org</a>.</p>
73
54
 
74
- <pre><code>Tips for installing and configuring ImageMagick and GraphicsMagick
75
- </code></pre>
55
+ <p>Either <strong>ImageMagick</strong> 6.0.0 or later, or any release of
56
+ <strong>GraphicsMagick</strong>. GraphicsMagick is a friendly fork of ImageMagick
57
+ 5.5.1. You can get ImageMagick from <a href="http://www.imagemagick.org">http://www.imagemagick.org</a>. You
58
+ can get GraphicsMagick from <a href="http://www.graphicsmagick.org">http://www.graphicsmagick.org</a>. ImageMagick
59
+ and GraphicsMagick have slightly different capabilities. Please consult
60
+ their web sites if you have questions.</p>
61
+
62
+ <h2 id="tips">Tips for installing and configuring ImageMagick and GraphicsMagick</h2>
76
63
 
77
- <p>if you are installing RMagick by compiling the source code, I /strongly/
64
+ <p>If you are installing RMagick by compiling the source code, I strongly
78
65
  encourage you to install the latest version of ImageMagick or
79
- GraphicsMagick /from source/. If you have never installed ImageMagick or
66
+ GraphicsMagick <em>from source</em>. If you have never installed ImageMagick or
80
67
  GraphicsMagick before, I also strongly encourage you to read the
81
- README.txt file as many times as is necessary for you to understand how
82
- to configure it. ImageMagick and GraphicsMagick are large and
83
- complicated programs and can be difficult to configure. Follow these
84
- tips to minimize the amount of time you'll spend and your frustration level.</p>
85
-
86
- <p>Do /not/ simply type ./configure and expect the defaults to be correct
87
- for you. Since you are installing ImageMagick/GraphicsMagick to use with
88
- Ruby, consider whether you want to skip ImageMagick's/GraphicMagicks'
89
- support for Perl and C++ by using the --without-perl and
90
- --without-magick-plus-plus options. Doing so will speed up the
91
- installation process and save some disk space. You will almost certainly
92
- want to specify the --enable-shared and --disable-static options.</p>
68
+ README.txt file as many times as is necessary for you to understand how to
69
+ configure it. ImageMagick and GraphicsMagick are large and complicated
70
+ programs and can be difficult to configure. Follow these tips to minimize
71
+ the amount of time you'll spend and your frustration level.</p>
72
+
73
+ <p><em>Do not</em> simply type <code>./configure</code> and expect the defaults to be correct
74
+ for you. Since you are installing ImageMagick/GraphicsMagick to use with
75
+ Ruby, consider whether you want to skip ImageMagick's/GraphicMagick's
76
+ support for Perl and C++ by using the <code>--without-perl</code> and
77
+ <code>--without-magick-plus-plus</code> options. Doing so will speed up the
78
+ installation process and save some disk space. You will almost certainly
79
+ want to specify the <code>--enable-shared</code> and <code>--disable-static</code> options.</p>
93
80
 
94
81
  <p>Determine which image formats you are interested in using and make sure
95
- that you have installed the libraries that ImageMagick/GraphicsMagick
96
- uses to process these formats. ImageMagick and GraphicsMagick use
97
- additional libraries to support some image formats. If you do not
98
- install those libraries you cannot read and write those image formats.
99
- You will need to configure ImageMagick/GraphicsMagick to support the
100
- JPG, PNG, TIFF, and WMF formats in order to execute all the RMagick
101
- sample programs. See ImageMagick's or GraphicMagick's README.txt file
102
- for more information.</p>
82
+ that you have installed the libraries that ImageMagick/GraphicsMagick uses
83
+ to process these formats. ImageMagick and GraphicsMagick use additional
84
+ libraries to support some image formats. If you do not install those
85
+ libraries you cannot read and write those image formats. You will need to
86
+ configure ImageMagick/GraphicsMagick to support the JPG, PNG, TIFF, and
87
+ WMF formats in order to execute all the RMagick sample programs. See
88
+ ImageMagick's or GraphicMagick's README.txt file for more information.</p>
103
89
 
104
90
  <p>Once you have determined the configuration options you need, run the
105
- configure script. When it completes, read the summary output to see if
106
- configuration worked the way you expected. Here's an example of the
107
- summary output from ImageMagick's configure script. Notice that the
91
+ configure script. When it completes, read the summary output to see if
92
+ configuration worked the way you expected. Here's an example of the
93
+ summary output from ImageMagick's configure script. Notice that the
108
94
  result of each option is listed in the "Configured value" column.</p>
109
95
 
110
- <h2> Option Value</h2>
111
-
112
- <p>Shared libraries --enable-shared=yes yes
96
+ <pre><code> Option Value
97
+ -------------------------------------------------------------------------
98
+ Shared libraries --enable-shared=yes yes
113
99
  Static libraries --enable-static=no no
114
100
  Module support --with-modules=yes yes
115
101
  GNU ld --with-gnu-ld=yes yes
116
102
  LZW support --enable-lzw=yes yes
117
- Quantum depth --with-quantum-depth=8 8</p>
103
+ Quantum depth --with-quantum-depth=8 8
118
104
 
119
- <p>Delegate Configuration:
105
+ Delegate Configuration:
120
106
  BZLIB --with-bzlib=yes yes
121
107
  DPS --with-dps=yes yes
122
108
  FlashPIX --with-fpx=yes no
@@ -137,288 +123,296 @@ Windows fonts --with-windows-font-dir=/mnt/windows/windows/fonts /mnt/win
137
123
  WMF --with-wmf=yes yes
138
124
  X11 --with-x= yes
139
125
  XML --with-xml=yes yes
140
- ZLIB --with-zlib=yes yes</p>
126
+ ZLIB --with-zlib=yes yes
141
127
 
142
- <p>X11 Configuration:
128
+ X11 Configuration:
143
129
  X_CFLAGS = -I/usr/X11R6/include
144
- X<em>PRE</em>LIBS = -lSM -lICE
130
+ X_PRE_LIBS = -lSM -lICE
145
131
  X_LIBS = -L/usr/X11R6/lib
146
- X<em>EXTRA</em>LIBS =</p>
132
+ X_EXTRA_LIBS =
133
+ </code></pre>
147
134
 
148
135
  <p>If the results are not what you wanted, install any missing libraries,
149
136
  choose new or different options, or whatever it takes, erase the
150
- config.cache file, and re-run configure. Repeat as often as necessary
151
- before moving to the <code>make' and</code>make install' steps.</p>
137
+ config.cache file, and re-run <code>configure</code>. Repeat as often as necessary
138
+ before moving to the <code>make</code> and <code>make install</code> steps.</p>
152
139
 
153
140
  <p>Detailed information about all of ImageMagick's and GraphicsMagick's
154
141
  configuration options may be found in their README.txt and INSTALL.txt
155
142
  files.</p>
156
143
 
157
- <pre><code> Windows Metafile Format
158
- </code></pre>
144
+ <h4>Windows Metafile Format</h4>
159
145
 
160
146
  <p>As noted in the ImageMagick and GraphicsMagick README.txt files, to
161
- support images in the Windows Metafile format,
162
- ImageMagick/GraphicsMagick requires an additional library. Without this
163
- library some of the RMagick sample programs will not work. ImageMagick
164
- and GraphicsMagick require libwmf 0.2.5, 0.2.7, or 0.2.2 to support the
165
- WMF format. (Avoid libwmf 0.2.6!)</p>
147
+ support images in the Windows Metafile format, ImageMagick/GraphicsMagick
148
+ requires an additional library. Without this library some of the RMagick
149
+ sample programs will not work. ImageMagick and GraphicsMagick require
150
+ libwmf 0.2.5, 0.2.7, or 0.2.2 to support the WMF format. (Avoid libwmf
151
+ 0.2.6!)</p>
166
152
 
167
- <pre><code>Installing RMagick
168
- </code></pre>
153
+ <h2 id="install">Installing RMagick</h2>
169
154
 
170
155
  <p>Installing RMagick is much simpler than installing ImageMagick or
171
- GraphicsMagick. Note that the /make/ step runs all the example programs.
172
- This process both builds the example images used in the documentation
173
- and validates your RMagick installation. This step can take 5-15 minutes
156
+ GraphicsMagick. Note that the make step runs all the example programs.
157
+ This process both builds the example images used in the documentation and
158
+ validates your RMagick installation. This step can take 5-15 minutes
174
159
  depending on the speed of your computer.</p>
175
160
 
176
- <pre><code> Configuration options
177
- </code></pre>
161
+ <h4 id="options">Configuration Options</h4>
178
162
 
179
- <p>Type |./configure --help| to see a list of configuration options. In
163
+ <p>Type <code>./configure --help</code> to see a list of configuration options. In
180
164
  addition to the regular options, there are a few RMagick-specific options:</p>
181
165
 
182
- <p>--with-doc-dir=directory
183
- Specify the directory to install the RMagick documentation. By
184
- default this is $prefix/share/RMagick, where $prefix is the prefix
185
- specified by --prefix. For example, to install the documentation in
186
- /home/user/RMagick, specify:</p>
187
-
188
- <p>./configure --with-doc-dir=/home/user/RMagick</p>
189
-
190
- <p>--enable-allow-example-errors
191
- Normally the documentation installation terminates if 5 examples
192
- fail. If you use this option, the installation does not check for
193
- failing examples and will always complete. This option is useful if
194
- you're having trouble installing RMagick and you want to see all the
195
- failing examples.
196
- --with-graphics-magick
197
- If you have both ImageMagick and GraphicsMagick installed, this
198
- option will force RMagick to be configured with GraphicsMagick.
199
- --with-so-dir=directory
200
- The directory for ruby extensions.
201
- --with-ruby-path=directory
202
- The path to set the !# line in Ruby scripts. The default is
203
- |$prefix/bin/ruby|.
204
- --with-ruby-prog=name
205
- The name of the Ruby executable. The default is |ruby|.
206
- --with-make-prog=name
207
- The name of the |make| program.
208
- --with-rbconfig=path
209
- The path to the rbconfig.rb file to use. The default is Ruby's rbconfig.</p>
210
-
211
- <pre><code> Running the |configure| and |make| scripts
212
- </code></pre>
213
-
214
- <p>De-compress the RMagick-1.7.4.tar.gz archive and enter the
215
- top directory. Then type:</p>
166
+ <ul>
167
+ <li><p>--with-doc-dir=<em>directory</em></p>
168
+
169
+ <blockquote>
170
+ <p>Specify the directory to install the RMagick documentation.
171
+ By default this is $prefix/share/RMagick, where $prefix is the
172
+ prefix specified by --prefix. For example, to install the
173
+ documentation in /home/user/RMagick, specify:</p>
174
+
175
+ <p><code>./configure --with-doc-dir=/home/user/RMagick</code></p>
176
+ </blockquote></li>
177
+ <li><p>--enable-allow-example-errors</p>
178
+
179
+ <blockquote>
180
+ <p>Normally the documentation installation terminates if 5 examples fail.
181
+ If you use this option, the installation does not check for failing
182
+ examples and will always complete. This option is useful if you're having
183
+ trouble installing RMagick and you want to see all the failing examples.</p>
184
+ </blockquote></li>
185
+ <li><p>--with-graphics-magick</p>
186
+
187
+ <blockquote>
188
+ <p>If you have both ImageMagick and GraphicsMagick installed, this option will
189
+ force RMagick to be configured with GraphicsMagick.</p>
190
+ </blockquote></li>
191
+ <li><p>--with-so-dir=<em>directory</em></p>
192
+
193
+ <blockquote>
194
+ <p>The directory for ruby extensions.</p>
195
+ </blockquote></li>
196
+ <li><p>--with-ruby-path=<em>directory</em></p>
197
+
198
+ <blockquote>
199
+ <p>The path to set the !# line in Ruby scripts. The default is $prefix/bin/ruby.</p>
200
+ </blockquote></li>
201
+ <li><p>--with-ruby-prog=<em>name</em></p>
202
+
203
+ <blockquote>
204
+ <p>The name of the Ruby executable. The default is <code>ruby</code>.</p>
205
+ </blockquote></li>
206
+ <li><p>--with-make-prog=<em>name</em></p>
207
+
208
+ <blockquote>
209
+ <p>The name of the <code>make</code> program.</p>
210
+ </blockquote></li>
211
+ <li><p>--with-rbconfig=<em>directory</em></p>
212
+
213
+ <blockquote>
214
+ <p>The directory of the rbconfig.rb file to use. The default is Ruby's
215
+ rbconfig.</p>
216
+ </blockquote></li>
217
+ </ul>
218
+
219
+ <h4 id="scripts">Running the <code>configure</code> and <code>make</code> scripts</h4>
220
+
221
+ <p>De-compress the RMagick-1.8.0.tar.gz archive and enter the top
222
+ directory. Then type:</p>
216
223
 
217
224
  <pre><code>$ ./configure &lt;configuration options&gt;
218
225
  $ make
226
+ ($ su)
227
+ $ make install
228
+ (optionally)
229
+ $ make clean
219
230
  </code></pre>
220
231
 
221
- <p>($ su)
222
- $ make install
223
- (optionally)
224
- $ make clean</p>
225
-
226
- <pre><code>Things that can go wrong
227
- </code></pre>
232
+ <h2 id="uhoh">Things that can go wrong</h2>
228
233
 
229
- <p><em>Cannot open shared object file</em></p>
234
+ <h4>Cannot open shared object file</h4>
230
235
 
231
- <pre><code>When |make| is running the examples, if you get a message like this:
232
- </code></pre>
236
+ <p>When make is running the examples, if you get a message like this:</p>
233
237
 
234
- <p>/home/you/RMagick-1.7.4/lib/RMagick.rb:11:in 'require': libMagick.so.0:
238
+ <pre><code>/home/you/RMagick-1.8.0/lib/RMagick.rb:11:in `require': libMagick.so.0:
235
239
  cannot open shared object file: No such file or directory -
236
- /home/you/RMagick-1.7.4/ext/RMagick/RMagick.so (LoadError)</p>
237
-
238
- <pre><code>you probably do not have the directory in which the ImageMagick or
239
- GraphicsMagick library is installed in your load path. An easy way
240
- to fix this is to define the directory in the LD_LIBRARY_PATH
241
- environment variable. For example, suppose you installed the
242
- GraphicsMagick library libGraphicsMagick.so in /usr/local/lib. (By
243
- default this is where it is installed.) Create the LD_LIBRARY_PATH
244
- variable like this:
240
+ /home/you/RMagick-1.8.0/ext/RMagick/RMagick.so (LoadError)
245
241
  </code></pre>
246
242
 
247
- <p>export LD<em>LIBRARY</em>PATH=/usr/local/lib</p>
243
+ <p>you probably do not have the directory in which the ImageMagick or GraphicsMagick
244
+ library is installed in your load path. An easy way to fix this is to define the
245
+ directory in the LD<em>LIBRARY</em>PATH environment variable. For example, suppose you
246
+ installed the GraphicsMagick library libGraphicsMagick.so in /usr/local/lib.
247
+ (By default this is where it is installed.) Create the LD<em>LIBRARY</em>PATH variable
248
+ like this:</p>
248
249
 
249
- <pre><code>On Linux, see |ld(1)| and |ld.so(8)| for more information. On other
250
- operating systems, see the documentation for the dynamic loading
251
- facility.
250
+ <pre><code>export LD_LIBRARY_PATH=/usr/local/lib
252
251
  </code></pre>
253
252
 
254
- <p><em>No such file or directory - "/tmp/rmagick6872.6"</em></p>
253
+ <p>On Linux, see <code>ld(1)</code> and <code>ld.so(8)</code> for more information. On other operating
254
+ systems, see the documentation for the dynamic loading facility.</p>
255
255
 
256
- <pre><code>When |make| is running the examples, if you get a message like this:
257
- </code></pre>
256
+ <h4>No such file or directory - "/tmp/rmagick6872.6"</h4>
258
257
 
259
- <p>hook /home/me/src/RMagick-1.7.4/./post-setup.rb failed:
260
- No such file or directory - "/tmp/rmagick6872.6"</p>
258
+ <p>When make is running the examples, if you get a message like this:</p>
261
259
 
262
- <pre><code>you probably do not have a temporary directory environment variable
263
- set. Set the TMPDIR environment variable to your temporary
264
- directory. For example:
260
+ <pre><code>hook /home/me/src/RMagick-1.8.0/./post-setup.rb failed:
261
+ No such file or directory - "/tmp/rmagick6872.6"
265
262
  </code></pre>
266
263
 
267
- <p>export TMPDIR=/home/me/tmp</p>
264
+ <p>you probably do not have a temporary directory environment variable set. Set
265
+ the TMPDIR environment variable to your temporary directory. For example:</p>
268
266
 
269
- <pre><code>Upgrading
267
+ <pre><code>export TMPDIR=/home/me/tmp
270
268
  </code></pre>
271
269
 
272
- <p>If you upgrade to a newer release of ImageMagick or GraphicsMagick, make
273
- sure you're using a release of RMagick that supports that release.
274
- Usually I put out a new release of RMagick with every new release of
275
- ImageMagick. It's safe to install a newer release of RMagick over an
276
- earlier release.</p>
270
+ <h2 id="upgrade">Upgrading</h2>
277
271
 
278
- <pre><code>Uninstalling
279
- </code></pre>
272
+ <p>If you upgrade to a newer release of ImageMagick or GraphicsMagick, make sure
273
+ you're using a release of RMagick that supports that release. Usually I put out
274
+ a new release of RMagick with every new release of ImageMagick. It's safe to
275
+ install a newer release of RMagick over an earlier release.</p>
280
276
 
281
- <p>The 'uninstall' target will uninstall RMagick completely:</p>
277
+ <h2 id="uninstall">Uninstalling</h2>
282
278
 
283
- <pre><code>|make uninstall|
279
+ <p>The <code>uninstall</code> target will uninstall RMagick completely:</p>
284
280
 
285
-
286
- More samples
281
+ <pre><code>make uninstall
287
282
  </code></pre>
288
283
 
284
+ <h2 id="samples">More samples</h2>
285
+
289
286
  <p>You can find more sample RMagick programs in the /example directory.
290
287
  These programs are not installed in the RMagick documentation tree.</p>
291
288
 
292
- <pre><code>Undocumented features
293
- </code></pre>
289
+ <h2 id="undoc">Undocumented features</h2>
294
290
 
295
291
  <p>This release includes an extra feature that isn't in the documentation.
296
292
  The Magick module defines two methods that control ImageMagick's logging
297
- function. This function is not officially documented by ImageMagick, so
298
- I have decided not to add them to RMagick's documentation. However, you
299
- may find them helpful for debugging your application. (Caveat: these two
300
- methods may change behavior or be removed without advance notice! You
301
- are on your own!)</p>
293
+ function. This function is not officially documented by ImageMagick, so I
294
+ have decided not to add them to RMagick's documentation. However, you may
295
+ find them helpful for debugging your application. (Caveat: these two
296
+ methods may change behavior or be removed without advance notice! You are
297
+ on your own!)</p>
302
298
 
303
- <p>/Magick::set<em>log</em>event_mask(event [,...]) -> Magick/</p>
299
+ <h5>Magick::set_log_event_mask(event [,...])</h5>
304
300
 
305
- <p>The arguments are one or more "event domains". The set<em>log</em>event_mask
306
- method recognizes these event domains: "all", "annotate", "blob",
307
- "cache", "coder", "configure", "deprecate", "draw", "locale", "none",
308
- "resource", "transform", "user", and "x11". ImageMagick events that
309
- match the mask are logged. The default domain is "none". For example,</p>
301
+ <p>The arguments are one or more "event domains". The set<em>log</em>event_mask
302
+ method recognizes these event domains: "all", "annotate", "blob", "cache",
303
+ "coder", "configure", "deprecate", "draw", "locale", "none", "resource",
304
+ "transform", "user", and "x11". ImageMagick events that match the mask
305
+ are logged. The default domain is "none". For example,</p>
310
306
 
311
- <pre><code> Magick::set_log_event_mask("render")
307
+ <pre><code> Magick::set_log_event_mask("render")
312
308
  </code></pre>
313
309
 
314
- <p>Logging is controlled by the log.mgk file, which may be found in the
315
- same directory as the delegates.mgk files. (See ImageMagick's README.txt
310
+ <p>Logging is controlled by the log.mgk file, which may be found in the same
311
+ directory as the delegates.mgk files. (See ImageMagick's README.txt
316
312
  file.) The purpose of the entries in this file is undocumented, so your
317
- guess is as good as mine. Also, the meaning of the event domains and
313
+ guess is as good as mine. Also, the meaning of the event domains and
318
314
  exactly what events are logged are undocumented.</p>
319
315
 
320
- <p>/Magick::set<em>log</em>format(format) -> Magick/</p>
321
-
322
- <p>The default log format is described in the log.mgk file. This method
323
- allows you to redefine the format at run-time. The format argument is a
324
- string similar to an fprintf format string. Each line in the log has the
325
- format described by the format string. Characters that are not control
326
- characters are printed as-is. The control characters are:</p>
327
-
328
- <pre><code> %t - the current time
329
- %r - the elapsed time
330
- %u - the user time
331
- %p - the pid (process id)
332
- %m - the name of the ImageMagick source file that contains the
333
- function that generated the event
334
- %f - the name of the ImageMagick function that generated the
335
- event
336
- %l - the line number in the source file
337
- %d - the event domain (one of the event mask strings listed above)
338
- %e - the event name
316
+ <h5>Magick::set_log_format(format)</h5>
317
+
318
+ <p>The default log format is described in the log.mgk file. This method
319
+ allows you to redefine the format at run-time. The format argument is a
320
+ string similar to an fprintf format string. Each line in the log has the
321
+ format described by the format string. Characters that are not control
322
+ characters are printed as-is. The control characters are:</p>
323
+
324
+ <pre><code> %t - the current time
325
+ %r - the elapsed time
326
+ %u - the user time
327
+ %p - the pid (process id)
328
+ %m - the name of the ImageMagick source file that contains the
329
+ function that generated the event
330
+ %f - the name of the ImageMagick function that generated the event
331
+ %l - the line number in the source file
332
+ %d - the event domain (one of the event mask strings listed above)
333
+ %e - the event name
339
334
  </code></pre>
340
335
 
341
336
  <p>For example, the default log format is:</p>
342
337
 
343
- <pre><code> Magick::set_log_format("%t %r %u %p %m/%f/%l/%d:\n %e")
344
-
345
-
346
- Known issues
338
+ <pre><code> Magick::set_log_format("%t %r %u %p %m/%f/%l/%d:\n %e")
347
339
  </code></pre>
348
340
 
349
- <ol>
350
- <li>gcc 3.2, during the "install.rb setup" step, issues the warning:</li>
351
- </ol>
352
-
353
- <p>cc1: warning: changing search order for system directory "/usr/local/include"
354
- cc1: warning: as it has already been specified as a non-system directory</p>
355
-
356
- <pre><code> This does not indicate a problem.
357
- </code></pre>
341
+ <h2 id="issues">Known issues</h2>
358
342
 
359
343
  <ol>
360
- <li>With older releases of ImageMagick you may see the warning:</li>
361
- </ol>
362
-
363
- <p>/usr/include/sys/ipc.h:25:3: warning: #warning "Files using this header must be compiled with <em>SVID</em>SOURCE or <em>XOPEN</em>SOURCE"</p>
344
+ <li><p>gcc 3.2, during the "install.rb setup" step, issues the following warning.
345
+ This does not indicate a problem.</p>
364
346
 
365
- <pre><code> This is harmless.
347
+ <p><code>cc1: warning: changing search order for system directory "/usr/local/include"</code> <br>
348
+ <code>cc1: warning: as it has already been specified as a non-system directory</code></p></li>
349
+ <li><p>With older releases of ImageMagick you may see this warning. It does not
350
+ indicate a problem.</p>
366
351
 
352
+ <p><code>/usr/include/sys/ipc.h:25:3: warning: #warning "Files using this header must
353
+ be compiled with _SVID_SOURCE or _XOPEN_SOURCE"</code></p></li>
354
+ </ol>
367
355
 
368
- Reporting bugs
369
- </code></pre>
356
+ <h2 id="bugs">Reporting bugs</h2>
370
357
 
371
358
  <p>Please report bugs in RMagick, its documentation, or its installation
372
- programs to me via the bug tracker on the RMagick project page
373
- <a href="http://rubyforge.org/projects/rmagick/">http://rubyforge.org/projects/rmagick/</a> at RubyForge. However, I cannot
374
- help with Ruby installation and configuration or ImageMagick or
375
- GraphicsMagick installation and configuration. Please report problems
376
- with that software to their respective authors or distributors.</p>
359
+ programs to me via the bug tracker on the <a href="http://rubyforge.org/projects/rmagick">RMagick project page at
360
+ RubyForge</a>. However, I can't help
361
+ with Ruby installation and configuration or ImageMagick or GraphicsMagick
362
+ installation and configuration. Please report problems with that software
363
+ to their respective authors or distributors.</p>
377
364
 
378
- <pre><code>Credits
379
- </code></pre>
365
+ <h2 id="credits">Credits</h2>
380
366
 
381
367
  <p>Thanks to</p>
382
368
 
383
- <pre><code>* Akinori MUSHA, for his work making RMagick available on FreeBSD.
384
- * Tom Payne, for reporting bugs, sending me the Ruby 1.8.0 patches,
385
- and for the Gentoo ebuild.
386
- * Bob Friesenhahn, for GraphicsMagick. Also for his help with the
387
- RMagick installation and many other things.
388
- * Simple Systems, for hosting the RMagick documentation online.
389
- * Mike Williams, for the RMagick Debian package
390
- * ImageMagick Studio LLC, for ImageMagick and for hosting the
391
- RMagick documentation.
392
- * Kaspar Schiess, for the MS Windows gem.
393
-
394
-
395
- License
396
- </code></pre>
397
-
398
- <p>Copyright � 2004 by Timothy P. Hunter</p>
399
-
400
- <p>Permission is hereby granted, free of charge, to any person obtaining a
401
- copy of this software and associated documentation files (the
402
- "Software"), to deal in the Software without restriction, including
403
- without limitation the rights to use, copy, modify, merge, publish,
404
- distribute, sublicense, and/or sell copies of the Software, and to
405
- permit persons to whom the Software is furnished to do so, subject to
406
- the following conditions:</p>
407
-
408
- <p>The above copyright notice and this permission notice shall be included
409
- in all copies or substantial portions of the Software.</p>
410
-
411
- <p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
412
- OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
413
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
414
- IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
415
- CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
416
- TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
417
- SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>
418
-
419
- <p><a href="http://www.opensource.org/docs/definition.php">http://www.opensource.org/docs/definition.php</a></p>
420
-
421
- <p>*This software is OSI Certified Open Source Software.
422
- OSI Certified is a certification mark of the Open Source Initiative.*</p>
369
+ <ul>
370
+ <li>Akinori MUSHA, for his work making RMagick available on FreeBSD.</li>
371
+ <li>Tom Payne, for reporting bugs, sending me the Ruby 1.8.0 patches, and for the Gentoo ebuild.</li>
372
+ <li>Bob Friesenhahn, for GraphicsMagick. Also for his help with the RMagick installation and many other things.</li>
373
+ <li>Simple Systems, for hosting the RMagick documentation online.</li>
374
+ <li>Mike Williams, for the RMagick Debian package</li>
375
+ <li>ImageMagick Studio LLC, for ImageMagick and for hosting the RMagick documentation.</li>
376
+ <li>Kaspar Schiess, for the MS Windows gem.</li>
377
+ <li>Jeremy Hinegardner, for the amd64 patch.</li>
378
+ </ul>
379
+
380
+ <h2 id="license">License</h2>
381
+
382
+ <blockquote>
383
+ <p>Copyright � 2005 by Timothy P. Hunter</p>
384
+
385
+ <p>Permission is hereby granted, free of charge, to any person obtaining a
386
+ copy of this software and associated documentation files (the "Software"),
387
+ to deal in the Software without restriction, including without limitation
388
+ the rights to use, copy, modify, merge, publish, distribute, sublicense,
389
+ and/or sell copies of the Software, and to permit persons to whom the
390
+ Software is furnished to do so, subject to the following conditions:</p>
391
+
392
+ <p>The above copyright notice and this permission notice shall be included in
393
+ all copies or substantial portions of the Software.</p>
394
+
395
+ <p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
396
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
397
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
398
+ THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
399
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
400
+ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
401
+ DEALINGS IN THE SOFTWARE.</p>
402
+ </blockquote>
403
+
404
+ <div align="center">
405
+ <a href="http://www.opensource.org/docs/definition.php">
406
+ <img src="http://opensource.org/trademarks/osi-certified/web/osi-certified-90x75.gif"
407
+ border="0" width="90" height="75">
408
+ </a>
409
+ </div>
410
+
411
+ <hr/>
412
+
413
+ <p><em>
414
+ This file is marked up using <a href="http://daringfireball.net/projects/markdown">Markdown</a>.
415
+ The HTML version was produced with <a href="http://bluecloth.rubyforge.org">BlueCloth</a>.
416
+ </em></p>
423
417
  </body>
424
418
  </html>