路径与子路径
在某一时刻,canvas之中只能有一条路径存在,Canvas规范将其称为“当前路径”(current path)。然而,这条路径却可以包含许多子路径(subpath)。而子路径,又是由两个或更多的点组成的。比方说,可以像这样绘制出两个矩形来:
- context.beginPath(); // Clear all subpaths from
- // the current path
- context.rect(10, 10, 100, 100); // Add a subpath with four points
- context.stroke(); // Stroke the subpath containing
- // four points
- context.beginPath(); // Clear all subpaths from the
- // current path
- context.rect(50, 50, 100, 100); // Add a subpath with four points
- context.stroke(); // Stroke the subpath containing
- // four points
以上这段代码通过调用beginPath()来开始一段新的路径,该方法会将当前路径中的所有子路径都清除掉。然后,这段代码调用了rect()方法,此方法向当前路径中增加了一个含有4个点的子路径。最后,调用stroke()方法,将当前路径的轮廓线描绘出来,使得这个矩形出现在canvas之中。
接下来,这段代码又一次调用了beginPath()方法,该方法清除了上一次调用rect()方法时所创建的子路径。然后,再一次调用rect()方法,这次还是会向当前路径中增加一段含有4个点的子路径。最后,对该路径进行描边,使得第二个矩形也出现在了canvas之中。
现在考虑一下,如果将第二个beginPath()调用去掉,会怎么样呢?像是这样:
- context.beginPath(); // Clear all subpaths from the
- // current path
- context.rect(10, 10, 100, 100); // Add a subpath with four points
- context.stroke(); // Stroke the subpath containing
- // four points
- context.rect(50, 50, 100, 100); // Add a second subpath with
- // four points
- context.stroke(); // Stroke both subpaths
上面这段代码在一开始与刚才那段是一样的:先调用beginPath()来清除当前路径中的所有子路径,然后调用rect()来创建一条包含矩形4个点的子路径,再调用stroke()方法使得这个矩形出现在canvas之上。
接下来,这段代码再次调用了rect()方法,不过这一次,由于没有调用beginPath()方法来清除原有的子路径,所以第二次对rect()方法的调用,会向当前路径中增加一条子路径。最后,该段代码再一次调用stroke()方法,这次对stroke()方法的调用,将会使得当前路径中的两条子路径都被描边,这意味着它会重绘第一个矩形。
填充路径时所使用的“非零环绕规则”
如果当前路径是循环的,或是包含多个相交的子路径,那么Canvas的绘图环境变量就必须要判断,当fill()方法被调用时,应该如何对当前路径进行填充。Canvas在填充那种互相有交叉的路径时,使用“非零环绕规则”(nonzero winding rule)来进行判断。图2-14演示了该规则的运用。
“非零环绕规则”是这么来判断有自我交叉情况的路径的:对于路径中的任意给定区域,从该区域内部画一条足够长的线段,使此线段的终点完全落在路径范围之外。图2-14中的那三个箭头所描述的就是上面这个步骤。
接下来,将计数器初始化为0,然后,每当这条线段与路径上的直线或曲线相交时,就改变计数器的值。如果是与路径的顺时针部分相交,则加1,如果是与路径的逆时针部分相交,则减1。若计数器的最终值不是0,那么此区域就在路径里面,在调用fill()方法时,浏览器就会对其进行填充。如果最终值是0,那么此区域就不在路径内部,浏览器也就不会对其进行填充了。
可以从图2-14中看出“非零环绕规则”是如何运用的。左边的那个带箭头的线段,先穿过了路径的逆时针部分,然后又穿过了路径的顺时针部分。这意味着其计数值是0,所以该线段起点所在的那个区域就不在范围内,在调用fill()方法时,浏览器也就不会对其进行填充。然而,其余两条带箭头的线段,其计数值都不是0,所以它们的起点所在的区域就会被浏览器填充。
路径
HTML5 Canvas的基本图形都是以路径为基础的。通常使用Context对象的moveTo()、lineTo()、rect()、arc()等方法先在画布中描出图形的路径点,然后使用fill()或者stroke()方法依照路径点来填充图形或者绘制线条。
通常,在开始描绘路径之前需要调用Context对象的beginPath()方法,其作用是清除之前的路径并提醒Context开始绘制一条新的路径,否则当调用stroke()方法的时候会绘制之前所有的路径,影响绘制效果,同时也因为重复多次操作而影响网页性能。另外,调用Context对象的closePath()方法可以显式地关闭当前路径,不过不会清除路径。
以下是一些描绘路径的方法的原型:
void moveTo(x, y);
用于显式地指定路径的起点。默认状态下,第一条路径的起点是画布的(0, 0)点,之后的起点是上一条路径的终点。两个参数分为表示起点的x、y坐标值。
void lineTo(x, y);
用于描绘一条从起点从指定位置的直线路径,描绘完成后绘制的起点会移动到该指定位置。参数表示指定位置的x、y坐标值。
void rect(left, top,width, height);
用于描绘一个已知左上角顶点位置以及宽和高的矩形,描绘完成后Context的绘制起点会移动到该矩形的左上角顶点。参数表示矩形左上角顶点的x、y坐标以及矩形的宽和高。
void arcTo(x1, y1, x2, y2,radius);
用于描绘一个与两条线段相切的圆弧,两条线段分别以当前Context绘制起点和(x2, y2)点为起点,都以(x1, y1)点为终点,圆弧的半径为radius。描绘完成后绘制起点会移动到以(x2, y2)为起点的线段与圆弧的切点。
void arc(x, y, radius,startAngle, endAngle, anticlockwise);
用于描绘一个以(x, y)点为圆心,radius为半径,startAngle为起始弧度,endAngle为终止弧度的圆弧。anticlockwise为布尔型的参数,true表示逆时针,false表示顺时针。参数中的两个弧度以0表示0°,位置在3点钟方向;Math.PI值表示180°,位置在9点钟方向。
void quadraticCurveTo(cpx,cpy, x, y);
用于描绘以当前Context绘制起点为起点,(cpx,cpy)点为控制点,(x, y)点为终点的二次样条曲线路径。
void bezierCurveTo(cpx1,cpy1, cpx2, cpy2, x, y);
用于描绘以当前Context绘制起点为起点,(cpx1,cpy1)点和(cpx2, cpy2)点为两个控制点,(x, y)点为终点的贝塞尔曲线路径。
路径描绘完成后,需要调用Context对象的fill()和stroke()方法来填充路径和绘制路径线条,或者调用clip()方法来剪辑Canvas区域。以上三个方法的原型如下:
void stroke();
用于按照已有的路径绘制线条。
void fill();
用于使用当前的填充风格来填充路径的区域。
void clip();
用于按照已有的路线在画布中设置剪辑区域。调用clip()方法之后,图形绘制代码只对剪辑区域有效而不再影响区域外的画布。如调用之前没有描绘路径(即默认状态下),则得到的剪辑区域为整个Canvas区域。
此外,Context对象还提供了相应的属性来调整线条及填充风格,如下所示:
strokeStyle
线条的颜色,默认为”#000000”,其值可以设置为CSS颜色值、渐变对象或者模式对象。
fillStyle
填充的颜色,默认为”#000000”,与strokeStyle一样,值也可以设置为CSS颜色值、渐变对象或者模式对象。
lineWidth
线条的宽度,单位是像素(px),默认为1.0。
lineCap
线条的端点样式,有butt(无)、round(圆头)、square(方头)三种类型可供选择,默认为butt。
lineJoin
线条的转折处样式,有round(圆角)、bevel(平角)、miter(尖角)三种;类型可供选择,默认为miter。
miterLimit
线条尖角折角的锐利程序,默认为10。