beginPath(路径命令)
context.beginPath()
开始组装一组新的路径命令,并丢弃任何先前组装的路径。
它还将绘图笔移动到画布的左上角原点(== coordinate [0,0])。
虽然是可选的,但你应该始终使用 beginPath
启动路径
丢弃是一个重要且经常被忽视的问题。如果未使用 beginPath
开始新路径,则将自动重绘以前发出的任何路径命令。
这两个演示都尝试用一个红色笔划和一个蓝色笔划绘制 X
。
第一个演示正确使用 beginPath
开始它的第二个红色笔画。结果是 X
正确地具有红色和蓝色笔划。
<!doctype html>
<html>
<head>
<style>
body{ background-color:white; }
#canvas{border:1px solid red; }
</style>
<script>
window.onload=(function(){
// get a reference to the canvas element and it's context
var canvas=document.getElementById("canvas");
var ctx=canvas.getContext("2d");
// draw a blue line
ctx.beginPath();
ctx.moveTo(30,30);
ctx.lineTo(100,100);
ctx.strokeStyle='blue';
ctx.lineWidth=3;
ctx.stroke();
// draw a red line
ctx.beginPath(); // Important to begin a new path!
ctx.moveTo(100,30);
ctx.lineTo(30,100);
ctx.strokeStyle='red';
ctx.lineWidth=3;
ctx.stroke();
}); // end window.onload
</script>
</head>
<body>
<canvas id="canvas" width=200 height=150></canvas>
</body>
</html>
第二次演示错误地在第二次击球时遗漏了 beginPath
。结果是 X
错误地具有两个红色笔划。
第二个 stroke()
绘制第二个红色笔划。
但是没有第二个 beginPath
,同样的第二个 stroke()
也错误地重绘了第一个笔划。
由于第二个 stroke()
现在被设置为红色,因此第一个蓝色笔划被错误着色的红色笔划覆盖。
<!doctype html>
<html>
<head>
<style>
body{ background-color:white; }
#canvas{border:1px solid red; }
</style>
<script>
window.onload=(function(){
// get a reference to the canvas element and it's context
var canvas=document.getElementById("canvas");
var ctx=canvas.getContext("2d");
// draw a blue line
ctx.beginPath();
ctx.moveTo(30,30);
ctx.lineTo(100,100);
ctx.strokeStyle='blue';
ctx.lineWidth=3;
ctx.stroke();
// draw a red line
// Note: The necessary 'beginPath' is missing!
ctx.moveTo(100,30);
ctx.lineTo(30,100);
ctx.strokeStyle='red';
ctx.lineWidth=3;
ctx.stroke();
}); // end window.onload
</script>
</head>
<body>
<canvas id="canvas" width=200 height=150></canvas>
</body>
</html>