beginPath(路径命令)

context.beginPath()

开始组装一组新的路径命令,并丢弃任何先前组装的路径。

它还将绘图移动到画布的左上角原点(== coordinate [0,0])。

虽然是可选的,但你应该始终使用 beginPath 启动路径

丢弃是一个重要且经常被忽视的问题。如果未使用 beginPath 开始新路径,则将自动重绘以前发出的任何路径命令。

这两个演示都尝试用一个红色笔划和一个蓝色笔划绘制 X

第一个演示正确使用 beginPath 开始它的第二个红色笔画。结果是 X 正确地具有红色和蓝色笔划。

StackOverflow 文档

<!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() 现在被设置为红色,因此第一个蓝色笔划被错误着色的红色笔划覆盖

StackOverflow 文档

<!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>