Rails上使用RMagick经验之谈

我的开发平台：winXP系统 + sp2， ruby 1.8.5，Rails 1.2.3，mysql5.0.27, RMagick-1.14.1_IM-6.3.0-7-Q8.当然，以上的开发软件都是windows版的。

RMagick的使用经验
这里需要说明的是：我并不打算做一个RMagick的使用大全，而只是结合我的使用经验对一些不太容易注意到的问题进行总结。
RMagick的API可以参考 www.gotapi.com
RMagick的使用：

1． 安装配置

在RMagick安装前，确保你的系统正确安装了ruby和rails。RMagick的 安装配置很简单：下载安装文件，解压缩后，在命令行状态下进入解压缩后的目录 ，找到RMagick的gem，如rmagick-1.14.1-win32.gem，然后命令行执行：gem rmagick-1.14.1-win32.gem，然后双击ImageMagick-6.3.0-7-Q8-windows-dll.exe进行安装， 只需要根据个人情况改变安装路径即可 。这部分内容有很多文章都有过详细的介绍，还有不明白的可以搜一下。

2． RMagick的基本使用

（1）定义主要对象
使用RMagick，重要会用到两个对象：Image和Draw。这两个对象可以形象的理解为：Image对象相当于画布，Draw对象相当于画笔。
为方便以下说明，我这样定义这两个对象：

ruby 代码

1. require‘rmagick’//千万别忘了在文件开头加上这段代码
2. canvas=Magick::Image.new(width,height,Magick::HatchFill.new(bg_color,bg_color))
3. gc=Magick::Draw.new

参数说明：Image对象定义的前两个参数是定义图片的宽和高，后门一个定义图片的背景（可选），默认为白色。
要读取一个存在的图片，Image对象还有如下定义方式：

ruby 代码

1. img=Magick::Image.read(image_path).first//image_path是字符串形式的图片路径
2. Image对象定义后，根据img.rows和img.columns可以获得它的高度和宽度。

（2）对象使用方法
gc对象的主要功能有：在图片上写字，在图片上画线，把另一张图片组合到当前图片上。下面我主要说两个问题：
在图片上写中文：
主要有两个方法gc.text,gc.annotate 相关参数可以在gotapi上轻松查到。用这两个方法写系统自带的英文字体是非常方便的，gc.font,gc.font_family可以设置字体，还 可以通过gc. font_style, gc.font_weight来设置斜体和粗体，它们的参数是类似Magick::ItalicStyle、Magick::NormalStyle、 Magick::BoldWeight、Magick::LighterWeight这样的常量。当然还有gc.pointsize来设置字体大小，这个 对于中英文是通用的。
我这里主要对写中文字体做一些介绍。由于RMagick对中文支持不好,当时使用它写中文的时候默认情况下只发现了黑体可以使用（当然是在我的 windows平台下）。因为我们图片处理需要提供多种字体来写字，还考虑到发布环境在linux下，所以我们用了这样的方法：从Windows的字体文 件夹c:/windows/fonts下拷贝出中文字体库到自己的工程目录中，然后通过设置gc.font来使用它们。下面是我的例子：

ruby 代码

1. require'RMagick'
3. img=Magick::Image.new(200,200,Magick::HatchFill.new('green','green'))
5. gc=Magick::Draw.new
6. gc.stroke('transparent')
7. gc.pointsize(24)
8. gc.font("fonts/STCAIYUN.TTF")
9. gc.text(20,40,'我爱你啊')
11. gc.font("fonts/STXINWEI.TTF")
12. gc.text(20,70,'我爱你啊')
14. gc.fill('white')
15. gc.font("fonts/FZSTK.TTF")
16. gc.text(20,100,'我爱你啊')
18. gc.font("fonts/simhei.ttf")
19. gc.text(20,130,'我爱你啊')
21. gc.font("fonts/yihejianti.TTF")
22. gc.text(20,160,'我爱你啊')
24. gc.draw(img)
25. img.write('love.jpg')

说明：如果你想保存并运行这段代码，请保存为 UTF-8的格式，否则会乱码，还要保证你当前文件的fonts目录下有这些ttf字库文件。

这里还要强调的是，在写字的时候一定要设置gc.stroke('transparent')。尽管gc.stroke最开始默认的是 transparent，但我还是建议在每次写字之前设置一次，否则如果在之前使用过gc.stroke并且设置了非transparent的值，那么写 出来的字会是下面这样的（我把transparent换成了red）
附件图片love2.jpg
当然，如果你想要达到这种效果则另当别论了。如果你想要写出更多的中文字体，那就去下载更多的字体库就可以了，是不是很简单？
我现在还有一个问题没有解决：不知道哪里可以下载中文字体的粗体斜体字库（如黑体，宋体，隶书、楷体等），麻烦知道的朋友告之，我的邮箱zhangxiaoyao067, gmail.com
继续罗嗦一点：对字体的设置有gc.font(ttf_file)和gc.font=ttf_file这两种方式，它们的区别在什么地方呢？还是用上面那 个例子来说明。如果其中所有的gc.font(ttf_file)换成gc.font=ttf_file,那么最后的结果会是
附件图片love3.jpg
看明白了吧？也就是用“=”的时候，只有最后一个起作用。

图片裁剪：
还是用代码来说明吧

ruby 代码

1. gc.define_clip_path('clip_pic'){
2. gc.stroke_width(0)
3. gc.rectangle(lefttop_x,lefttop_y,rightbottom_x,rightbottom_y)}
4. gc.push
5. gc.clip_path('clip_pic')
6. gc.composite(x,y,width,height,Magick::Image.read(myImageUrl))
7. gc.pop

说明：首先要定义一个裁剪区域，这里我定义了一个矩形区域，然后是应用。只有在裁剪区域内部的图片才会画到画布上面。这里要注意的是gc.push, gc.pop，因为gc.clip_path的裁剪会应用在gc的整个存活期内部，因此gc.draw的所有内容都会限制在这个裁剪区域内部。这两个操作 相当于对裁剪应用的释放。