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