学习RaphaelJS矢量图形包--Learning Raphael JS Vector Graphics中文翻译（一）

（原文地址：http://www.cnblogs.com/idealer3d/p/LearningRaphaelJSVectorGraphics.html）

前面3篇博文里面，我们讲解了一本叫做《Instant RaphaelJS Starter》的书，那本书里我们将RaphaelJS里面的基本内容都进行了比较详细的讲解。但是，坦白的说，那本书通俗易懂却太过浅显。现在我们下一本叫做《Learning Raphael JS Vector Graphics》的书，算是上一本的进阶。当然，它里面大部分篇幅也是基本内容。因为一本书不能去讲一个写复杂的业务问题，你所要做的也是学会基本内容然后自己去活用。我这里翻译此书的目的，第一是想加深对于RaphaelJS的理解，第二是本来也是要读这本书的，就顺带翻译了，或许还能给英语不拿手的同志们有点帮助，第三就是寻找一些突破的契机去解决我现在碰到的问题。好了，废话少说。新的一本书，大家可以去网上搜索一下，应该可以找到下载。

和上本书一样，本书前面的几页是一些序言、版权声明等东西，这里我也略过不讲了。我们从目录页开始讲。如果你认真学习过前面3篇翻译上本书博文的内容，这本书的目录写出来的时候，你就应该能明白每个章节讲的是什么内容。

                         目录

序言 --------------------------------------------------- 1

第一章: Web图形---------------------------------------- 5

在Web上绘制矢量图---------------------------------- 6

矢量图形绘制包-----------------------------------7

详述SVG-------------------------------------------- 8

使用RaphaelJS包而不是直接使用SVG-------------- 9

RaphaelJS的应用--------------------------------------9

下载RaphaelJS-------------------------------------- 10

创建RaphaelJS的Js项目------------------------------ 11

项目的构建与优化 --------------------------------11

小结-------------------------------------------------11

第二章: RaphaelJS基本图形绘制 --------------------------13

绘制环境------------------------------------------- 13

画布坐标系-------------------------------------- 15

绘制基本图形---------------------------------------- 16

导入图片--------------------------------------------18

Raphael元素属性------------------------------------ 18

简单（基础）填充-------------------------------- 19

图片填充---------------------------------------- 19

应用笔画---------------------------------------- 20

其它属性---------------------------------------- 21

超链接--------------------------------------21

透明度--------------------------------------22

矩形裁剪------------------------------------22

渐变应用----------------------------------------23

线性渐变------------------------------------ 23

径向渐变------------------------------------ 25

元素分组---------------------------------------- 27

使用文本-------------------------------------------- 28

引用常用字体------------------------------------ 29

小结-------------------------------------------------30

第三章: 绘制Path（路径）---------------------------- ----31

Path绘制概念--------------------------------------- 32

Path绘制命令--------------------------------------- 33

"移动到"命令------------------------------------34

"连接到"命令----------------------------------- 35

"关闭路径"命令--------------------------------- 37

绘制曲线------------------------------------------- 38

二次贝塞尔曲线--------------------------------- 38

三次贝塞尔曲线--------------------------------- 41

绘制弧线--------------------------------------- 43

Path中比较实用的方法------------------------------- 46

Element.getTotalLength() ---------------------46

Element.getPointAtLength(length) -------------47

Element.getSubpath(from, to)----------------- 48

Catmull-Rom弧线------------------------------- 49

小结----------------------------------------------- 50

第四章: 变形转换和事件处理------------------------------ 51

基本图形变换和事件处理------------------------------52

基本图形变换------------------------------------52

平移----------------------------------------53

旋转--------------------------------------- 53

缩放----------------------------------------55

基本事件响应----------------------------------- 55

注册基本事件响应 ---------------------------55

注销基本事件响应----------------------------57

使用矩阵------------------------------------------- 58

转换矩阵--------------------------------------- 58

使用转换矩阵----------------------------------- 58

拖放功能------------------------------------------- 60

Element.drag() 方法 ---------------------------60

onstart事件----------------------------------- 60

onend事件------------------------------------ 60

onmove事件---------------------------------- 60

拖动的例子-------------------------------- 61

丢下元素------------------------------------------ 62

边界框覆盖 -----------------------------------62

边界框中的边界框 -----------------------------63

小结--------------------------------------------- 64

第五章: 向量动画--------------------------------------- 65

基本动画 ---------------------------------------66

变换路径------------------------------------------ 67

缓动类型 ------------------------------------------70

内建的缓动算法规则 ----------------------------70

使用三次贝塞尔公式的缓动 ----------------------71

动画转换 ------------------------------------------72

动画常用属性-------------------------------------- 73

常用属性 --------------------------------------73

随着一个长路径动画-----------------------------76

动画的暂停和重新开始-----------------------78

小结------------------------------------------------79

第六章: 使用已经存在的SVG文件--------------------------81

Inkscape ------------------------------------------82

下载Inkscape-----------------------------------82

开始使用Inkscape-------------------------------82

检查path------------------------------------------87

Inkscape的XML编辑器-------------------------87

从存在的SVG图片中提取path-------------------89

SVG转换到raphael对象的工具-----------------------90

Ready Set Raphael ---------------------------90

其它转换工具 ----------------------------------91

等值域图 ------------------------------------------92

创建等值域图 ----------------------------------92

开源SVG文件---------------------------------- 96

小结-----------------------------------------------96

第七章: 创建一个可视化社交媒体--------------------------97

社交媒体应用--------------------------------------- 97

开始--------------------------------------------98

使用JQeury-------------------------------------99

系统可用数据------------------------------------99

绘制人型图表-----------------------------------100

图表点击响应-----------------------------------101

绘制一把钥匙-----------------------------------102

随时间发布消息-------------------------------------103

开始-------------------------------------------104

推送的数据-------------------------------------104

（第七章这里有些专业术语，我在没读到这里之前，暂时不能获得准确的意思，抱歉，翻译到这里的时候讲把这里补充一下。）

我们从正文第一章开始讲。

Web图形

在当前浏览器的领域，图形的绘制是非常重要的。从图表到简单图片，从数学到视觉艺术，哪里都需要图形的绘制。所以浏览器对于这块功能的需求大增。所以以此衍生了很多相关技术。不止VML和SVG，HTML5 Canvas和WebGL.每个都有它们适用的领域，VML和SVG处理2D矢量图，HTML5Canvas的位图绘制以及WebGL的3D绘制渲染。

本书讲述一个开源和轻量级的JS库，Raphael，它使用SVG和VML在浏览器中绘制矢量图形。 它提供了很多非常方便的用户绘制和变换矢量图的方法，在支持直接操作DOM的同时还支持导入位图以及文本的绘制。它就是SVG和VML的优秀合体。一位内它已经将底层封装完善，我们在使用时不需要去考虑SVG和VML的方面问题，只要集中精力搞好我们的Raphael就可以了。

VML是微软设计并且在1998年提交给W3C，基于XML技术的在IE版本5+后绘制矢量图形。SVG使用W3C组织在2001自己推出的适量绘制图形技术。也是基于XML的文件组织，但是它适用于所有主流浏览器。IE在9以后的版本也开始支持SVG。

矢量图形绘制包

现在有很多比较成熟可用的矢量图形绘制JS包。除了RaphaelJS，还有两个非常流行的矢量图形绘制工具包，Paper.js和D3.js,每个都有它们各种优缺点。下面有一个简单的比较：

包名称          IE6,7,8支持            开箱即用（个人理解是开源）   低层次包（意味着你可以操作的空间更大）

Raphael           Yes                        Yes                                   Yes

D3.js               No                         No                                     No

Paper.js           No                         No                                     No

Raphael是为一个支持VML的矢量图形绘制包，其余的包都支持SVG，但是由于是高级包，在使用虽然可能简单一些，但是你操作性大减。当我们可以直接对底层内容进行操作时，你会发现我们可以做的事情要远比其它的多，当然代价就是学习周期长，难度大（实话说，如果你只是做比较普通的功能，Raphael还是非常简单的，但是对于复杂的操作有些引擎操作需要自己去实现，还是有难度的）。

 SVG说明

SVG是当今Web应用最广泛的矢量图形绘制技术。所有主流浏览器都提供了全方位的支持，甚至最新的手机浏览器都已经加入对SVG的支持。

SVG是基于XML的，就是标签对格式的。比如我们要画从坐标(50，50)的点画一个黑色实心线段到点(10,10)可以用下面的代码：

<path d="M50 50 L10 10" stroke-width="1" stroke="#000" />

除了路径path之外，SVG还支持图形绘制、文本、填充、渐变、动画以及用户绑定的事件响应。你可以在http://raphaeljsvectorgraphics.com/the-graphical-web/raw-svg/网站上查看一些SVG的例子。

Raphael基本XML语言，所以这本书看完后，你会非常熟悉一些SVG的语法，特别是和path有关的。

使用Raphael而不要直接使用SVG

撇开浏览器支持不说，有一个非常好的原因让我们使用Raphael而不是直接写原生态的SVG，因为它让矢量绘制简单更多。举个例子，我门要画一个矩形并且让它的宽度从50px动画变成100px。原生态的SVG代码：

<rect x="10" y="10" width="50" height="30">

<animate attributeType="XML"

attributeName="width"

to="100"

fill="freeze"

dur="1s" />

</rect>

我们在(10,10)坐标位置开始画一个宽50px，高30px的矩形也就是<rect>标签，然后需要在内部、嵌入一个<animate>标签，然后在animate标签里面，并且进行说明哪里要变、怎么变。还要有fill="freeze"来保持变换的形状，否则会被重置。这样看上去代码冗长而且不易操作。但是我们使用Raphael的话，只需要：

var rect = paper.rect(10, 10, 50, 30);

rect.animate({

width: 100

}, 1000);

我们的矩形创建和动画变动都更加简洁，而且如果你要变动的内容更多，那就对比更明显。另外Raphael可以很好与其它包整合，比如jQeury，这归功于Raphael声明一个全局的变量Raphael。

Raphael的应用

Raphael现在已经广泛应用在从地图制图Town Hall @ the White House event(http://askobama.twitter.com/)到网络小游戏比如Ebocs(http://www.dejapong.com/ebocs/).

Raphael特别适用于制图方面，因为RaphaelJS库为我们提供了直接操作DOM元素的能力并且我们还可以随意缩放而不担心图片的失真。你可以在http://raphaeljs.com/australia.html 找到一些很好的例子。

（接下来讲的内容是如何下载RaphaelJS并且搭建起来环境，我们在第一篇博文里面已经有说明大家可以去看那个，这里不再赘述。地址：http://www.cnblogs.com/idealer3d/p/Instant_RaphaelJS_Starter.html）。还有大家搭建项目的时候要规划好，特别是文件夹以及路径要管理规范。

第二章 使用Raphael绘制基本图形

Raphael提供了图形绘制的基本元素：形状、图片和文本。图形有预定义的矩形、圆形、椭圆以及组合图形等。图形和文本是可以填充的。变框的填充只能是单色但是可以修改。填充可以是线性也可以是渐变的。

绘制环境

要绘制图形，我们需要一个绘制的环境。我们需要创建一个空间供我们去绘制和储存。就像艺术家一样，我们需要一个画布。浏览器的视口，就是我们的画布。SVG标准把视口认为是绘制区域自己，我们一般认为浏览器区域就是视口了。我们利用Raphael去创建画布的代码如下：

var paper= Raphael(50,100,500,300);

它的效果如下：

如上图所示，我们在视口的区域，离左上角x轴（横轴）50px，y轴（竖轴）100px的位置开始创建一个宽500，高300的矩形框，这就是我们的画布。也就是说，paper对象，就是我们的画布。我们更推荐，我们利用已经存在的dom元素来建立画布而不是直接利用视口。在这种情况下，我们的画布的位置就是相对DOM元素的位置来讲的：

<div id="my-canvas"></div>

我们可以根据如下代码来建立画布：

var paper=Raphael("my-canvas",500,300);

也就是我们根据一个DOM的id去建立画布。当然直接用Id也可以，获得DOM对象也可以：

Raphael(document.getElementById("my-canvas"),500,300);

画布坐标系

我们可以根据下面的插图来理解画布的坐标系：

看图我们可以发现，坐标系原点在画布的左上角。（0,0）开始，x轴为从左到右，y轴为从上到下。另外如果出现负值，则位置如下：

这里是比较好理解的，但是需要注意的是，在负值的区域是不可见的：

Hidden:隐藏；Visible：可见的。

坐标系弄清楚以后，我们就可以开始绘制我们的图形了。

绘制基本图形

Raphael提供了矩形、圆形、椭圆的作为基本图形的预定义绘制方法。我们创建的画布对象可以调用这些方法。Rect矩形的绘制语法：

Paper.rect(x,y,width,height,[r]);

我们可以看到paper.rect共有5个参数，其中前4个为必须参数，第五个为可选参数。前两个，x,y 其实参照我们创建画布就可以理解，这里的x,y是在画布坐标系的(x,y)位置开始绘制，绘制一个宽度为第三个参数width、高度为第四个参数height的矩形。如果第5个参数设置并且大于0，则为圆角矩形。[r]以为圆角的半径。代码示例将在下面贴出。我们先讲解圆形和椭圆。圆形的绘制语法：

Paper.circle(x,y,r);

在(x,y)位置绘制一个半径为r的的圆。椭圆的语法：

Paper.ellipse(x,y,x-radius,y-radius);

在(x,y)位置绘制一个横向半径为x-radius，竖向半径y-radius的椭圆。代码如下：

<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
        <title>Raphael Test</title>
    </head>
    <body>
        <div id="my-canvas" style="padding:0px;margin:0px;border:solid;">
        </div>
        <!--some html doms-->
        <!--some scripts-->
        <script type="text/javascript" src="../js/lib/raphael.js">
        </script>
        <script type="text/javascript">
            //在my-canvas节点上面创建画布
            var paper = Raphael("my-canvas", 500, 300);
            //在(20,20)位置创建一个宽100，高60的直角矩形
            var rect = paper.rect(20, 20, 100, 60);
            //在(140,20)位置创建一个宽100，高60，圆角半径10的圆角矩形
            var rectR = paper.rect(160, 20, 100, 60, 10);
            //在(50,150)位置绘制一个半径为40的圆形
            var cir = paper.circle(50, 150, 40);
            //在(150,150)绘制一个横向半径50，竖向半径35的椭圆
            var ellipse = paper.ellipse(150, 150, 50, 35);
            //位置提示
            var tip = paper.text(5, 20, "(10,20)");
            var tipR = paper.text(145, 20, "(160,20)");
            var tipC = paper.text(50, 150, "(100,50)");
            var tipE = paper.text(150, 150, "(100,140)");
        </script>
    </body>
</html>

效果图如下：

如上图，我们在代码中有每个图形的详细解释，这里不多解释，大家可以阅读代码中的注释。这里再引用原书的椭圆图形加深理解：

导入图片

Raphael允许我们导入位图至画布中。语法如下：

paper.image("a.png",50,50,200,200);

意味着我们在(50,50)的位置导入一个图片，图片被缩放到长200，宽200.图片的路径和名字为："a.png"。我们在上面的那段代码中加入：

//导入图片
var agirl=paper.image("../images/mm.jpg",300,100,200,300);

效果如下：

接下来我们继续介绍每个我们创建的元素自带的属性。

元素属性

我们绘制的图形都可以有填充、边框属性以及其它的很多属性。我们创建图形的时候，每个方法返回一个图形对象，而这些对象就可以去赋予我们想要的属性。这些对象都有一个attr()方法，里面参数为键值对（json），键为元素属性名称，值为属性取值。

填充

我们首先介绍填充属性。填充可以是基本填充或者图形填充。基本填充我们使用颜色去填充一个形状，颜色的格式可以是#rrggbb、简写#rgb、rgb(r,g,b)甚至是颜色的英文单词red、green等。我们在前面那段代码中添加如下代码测试：

  rect.attr({
     fill: "#000"
   });
  rectR.attr({
      fill:"rgb(0,0,0)"
    });
  cir.attr({
      fill: "green"
     });
  ellipse.attr({
      fill: "url(../images/mm.jpg)"
    });

效果图如下：

不过我们使用位图填充椭圆的时候，由于椭圆太小我们这里只有原位图的右上角被填充到了椭圆中。这里大家理解就好啦。

处理笔画（边框）

元素的笔画有很多属性，最常用的是颜色和宽度。属性的键名就是"stroke","stroke-width"。因此，我们把刚才代码中添加几行新的代码：

var newcir = paper.circle(50, 250, 40);
            newcir.attr({
                fill: "green",
                stroke: "red",
                'stroke-width': "10"
            });

我们可以通过比叫两个圆的不同来看到stroke笔画设置的不同。这里需要知道的是，我们代码里面的笔画宽度是10，其实这个10有一半也就是5是在图形内部，而剩余的则是在图形的外面。也就是在你设置的笔画宽度的中间是图形的真是大小（准确的说，是你期望的图形大小）。其实，即便我们不设置笔画属性，我们所绘制的所有图形都有自带的笔画属性，他们的宽度是1px。如果你确实不想设置笔画属性，那么你需要显式地设置stroke-width:none。当然还有其它一些stroke属性这里没有提及，大家如果想了解可以到RaphaelJS的官方网站去查阅资料。

其它属性

      herf

      元素上面添加一个链接，允许这个dom元素扮演一个超链接的角色。当点击这个图形时，它将打开一个新的链接。（为了演示方便，我们另起一份代码，刚才的代码内容已经比较繁杂）。代码：

 var paper = Raphael("my-canvas", 500, 400);
            var rect = paper.rect(30, 30, 140, 140);
            rect.attr({
                fill: "green",
                href: "http://www.baidu.com"
            });

原书上讲，这里将创建一个表现为超链接的矩形。但是我实际测试中点击并没有作用，这里我还需要找找问题。我们暂时记下来，继续往下走。

透明度

元素透明度键名opacity,取值范围为0（完全不透明）到1（完全透明），也可以分别设置stroke-opacity和fill-opacity。我们前面说过，stroke是以中心来还，一半在外，一半在内。这里就会出现副作用，因为可以分别设置透明度而导致分开设置透明度会有一些限制。这里我们不再贴代码，原书的例子很好，我就直接贴出来了：

矩形切割

Raphael支持通过clip-rect属性来进行元素的矩形切割，它允许我们将图形切割出一部分下来。我们可以按照下面的代码来进行图形区域切割：

 var paper = Raphael("my-canvas", 500, 400);
            var circle = paper.circle(100, 100, 80);
            //原书是在attr里面直接加入了'clip-rect'属性，将圆的1/4切割下来，我们分开两步加入动画，以便理解。这里最终达到的效果与原书一致
            circle.attr({
                fill: "pink",
                'stroke-width': 0,
            });
            circle.animate({
                'clip-rect': '20,20,80,80'
            }, 2000,'easeIn');

大家将这段代码替换上面那大段代码的js部分就可以看到效果了。效果如下：

2秒后：

clip-rect属性的4个参数与矩形创建是一致的，x,y坐标开始宽、高定制的矩形。原书辅助解释的图：

虚线圆就是我们创建的circle对象，粉红色的部分就是设置该属性后剩余的部分。

渐变

Raphael支持线性和梯度渐变去填充图形，要达到这个效果，而不是直接用一个颜色的字符串去设置fill属性。我们需要指定了下面这种字符串的格式去做到线性渐变：

<angle>-<color>[-<color>[:<offset>]]*-<color>

下面的语法就是达到径向渐变的效果：

r[(<fx>,<fy>)]<color>[-<color>[:<offset>]]*-<color>

好吧，我承认我也没看懂。我们来看例子帮助我这智五渣理解一下。

线性渐变

      最基本的线性渐变的格式：

<angle>-<color1>-<color2>

比如：

var rect=paper.rect(20,20,160,160);

rect.attr({

'stroke-width':0,

fill:'0-#f00-#000'

})

我们去实验一下：

            var paper = Raphael("my-canvas", 500, 400);
            var rect = paper.rect(50, 50, 100, 100);
            var rect1 = paper.rect(200, 50, 100, 100);
            var rect2 = paper.rect(350, 50, 100, 100);
            rect.attr({
                'stroke-width': 0,
                fill: '0-#f00-#000'
            });
            rect1.attr({
                'stroke-width': 0,
                fill: '90-#f00-#000'
            });
            rect2.attr({
                'stroke-width': 0,
                fill: '45-#f00-#000'
            })

还是把这段复制到js部分就可以了，我们的运行效果图：

3个矩形，我们分别按照0度角、90度角、45度角实现从红色到黑色的渐变。嘿嘿，似乎上面那段奇怪的代码也不怎么难嘛。

注意，我们的角度计算是从x轴正方向沿逆时针方向来定义角度（--这句话其实就是说角度和我们脑子里的原始想法一致，不要去纠结其它）。

线性渐变可以有任意个数的颜色和这些颜色组成线性渐变的点，定义为offsets 。也就是有了下面的语法结构：

[-<color>[:<offset>]]*

在这里，任何个数的-color:offset组合可以用来创建。比如，我们使用下面的string来看看：

fill:"0-#00a9e0-#323490:20-#ea1688:40-#eb2e2e:60-#fde92d:80-#009e54"

我们用上面那行字符串可以建立一个彩虹样式的矩形，每个颜色相比前一个颜色多占据20%。下面的字符串可以达到相同效果：

"0-#00a9e0-#323490-#ea1688-#eb2e2e-#fde92d-#009e54"

这里只要把字符串贴到上面我们js代码的fill属性就行了，就不再截图举例了。

径向渐变

径向渐变与线性渐变相似，但是径向渐变绘制的时候是放射式的，从一个点开始（默认图形的中心点），最基本的径向渐变的语法：

r<color>-<color>

比如，我们在代码里面加入：

    var paper = Raphael("my-canvas", 500, 400);
            var circle = paper.circle(150, 150, 100);
            circle.attr({
                'stroke-width': 0,
                fill: 'r#f00-000'
            })

我们可以得到：

我们得到一个从中心为红色渐变到边缘为黑色的圆形。根据我们上面线性渐变的描述，我们根据offsets属性去“分段”定义颜色渐变，我们试验一下径向渐变的offsets效果：

  circle.attr({
                'stroke-width': 0,
                fill: 'r#f00-000:80-#f00'
            })

我们把上面的circle对象attr方法修改为上面的这句，效果如下：

呶？看出来区别了吧。那么估计有童鞋要问了，我不想从中心点开始画啊，我想随意的点，记得前面语法出现的fx和fy吗，它们就是来做这个的。这里我就不详细举代码例子了，袁术的配图真是不错，一看就可以明白：

我们发现我在r命令后面的括号里面添加好fx和fy的值，可以获得不同效果。fx和fy很容易能看出来取值范围为[0,1]，其实就是中心点在图形的x和y最大值的比例位置。这里很容易理解，不多做解释了。

最后，提一点，path对象是不能用径向渐变的。这是因为VML在这里有bug，所以这里的径向渐变只适用于基本图形。