在 HTML5 Canvas 中,幾乎所有圖形都可以透過「路徑」(path)來完成。所謂路徑,本質上就是一串座標點,以及連接這些點所構成的線段。本文整理自 Steve Fulton 與 Jeff Fulton 所著《HTML5 Canvas》第二章「Using Paths to Create Lines」的核心觀念,並加入實作範例。
要特別注意的是,每個 Canvas 上下文在同一時間只維護一個「當前路徑」。而且當你呼叫 context.save() 時,這個當前路徑並不會被保存下來,這點與其他繪圖狀態的處理方式不同,需要牢記。
呼叫 beginPath() 可以開啟一段新的路徑,而呼叫 closePath() 則會結束當前路徑。若把路徑中的點依序連接起來,就形成所謂的「子路徑」。當某個子路徑的最後一個點又與它的第一個點相連時,我們便稱這個子路徑是「閉合」的。
最基礎的路徑操作,就是不斷呼叫 moveTo() 與 lineTo()。以下範例示範如何畫出一條水平線段:
function drawScreen() {
context.strokeStyle = "black";
context.lineWidth = 10;
context.lineCap = 'square';
context.beginPath();
context.moveTo(20, 0);
context.lineTo(100, 0);
context.stroke();
context.closePath();
}
這段程式碼描繪了一條寬度為 10 像素的水平線,同時設定了 lineCap 與 strokeStyle 屬性。以下整理幾個常用屬性:
決定線段兩端的外觀,可設為以下三種值:
butt:預設值,在兩端加上平直邊緣。
round:在兩端各加上一個半圓形線帽,線帽直徑等於線段寬度。
square:在兩端加上正方形線帽,線帽邊長等於線段寬度。
決定兩條線段相交處的轉角樣式,可設為以下三種值:
miter:預設值,形成尖角。可透過 miterLimit 屬性限制尖角長度,該值為尖角長度與線條寬度比值的最大值,預設為 10。
bevel:形成斜角。
round:形成圓角。
定義線條的粗細,預設值為 1.0。
定義渲染線條所使用的顏色等樣式。
譯註:當 lineJoin 設為 miter,但尖角長度超過了 miterLimit 的限制時,Canvas 會自動改用 bevel 的效果來顯示轉角。