動手畫圖之前,先把「畫布」這塊地方看清楚。Canvas 就像一張方格紙,理解它的網格與座標系統,後面的每一筆才有依據。
上一頁的 HTML 範本裡放了一個寬 150px、高 150px 的 canvas 元素。若在它上面疊上預設網格,你會發現:網格上的一個單位,通常就對應畫布上的一個像素。
關鍵在於原點的位置——它固定在左上角,座標為 (0,0)。畫布裡所有元素的落點,都是相對於這個原點來計算的。因此一個藍色方塊若被放在「距左側 x 像素、距頂部 y 像素」的位置,我們就說它的座標是 (x, y)。
再往後的章節你會學到更進階的手法:把原點搬走(translate)、旋轉網格、甚至縮放座標系。現在先老實沿用預設設定即可。
和 SVG 不同,Canvas 天生只支援一種基本圖形——矩形。其他任何形狀,都得靠一條以上的「路徑(path)」拼出來。好消息是,Canvas 提供了一整套路徑繪製函式,足以組出相當複雜的圖形。
fillRect(x, y, width, height):畫出填滿的矩形
strokeRect(x, y, width, height):只畫矩形外框
clearRect(x, y, width, height):把指定區域清空,變成完全透明
三者參數一致:x、y 是矩形左上角相對於原點的位置,width 與 height 顧名思義就是寬與高。
function draw(){
var canvas = document.getElementById('tutorial');
if (canvas.getContext){
var ctx = canvas.getContext('2d');
ctx.fillRect(25, 25, 100, 100);
ctx.clearRect(45, 45, 60, 60);
ctx.strokeRect(50, 50, 50, 50);
}
}
這段程式依序做了三件事:fillRect 畫出一塊 100×100 的黑色實心方塊;clearRect 從中央挖掉 60×60 的透明區域;最後 strokeRect 在這個空洞裡描出一個 50×50 的方框。後續章節還會介紹另外兩種替代 clearRect 的做法,以及如何更換填色與描邊樣式。
要特別記住:這三個矩形函式是「即時生效」的,呼叫後立刻畫到畫布上,和下一節的路徑函式行為不同。
路徑的繪製流程比矩形多幾個環節,核心函式有這幾個:
beginPath() / closePath() / stroke() / fill()
第一步,呼叫 beginPath() 建立新路徑。內部實作上,路徑其實是一串子路徑(直線、弧線等)組成的清單;每次呼叫 beginPath(),這份清單就會被清空,讓你能重新開始畫。
第二步,呼叫真正描述路徑形狀的函式(例如 moveTo、lineTo、arc 等)。
第三步是可選的 closePath()。它會用一條直線把「目前端點」連回「起點」,嘗試將圖形閉合;如果圖形本來就已封閉,或清單裡只有一個點,這個函式什麼也不做。
最後一步是 stroke() 和/或 fill()。呼叫它們,圖形才真正被畫到畫布上:stroke 描邊,fill 填成實心。
注意:呼叫 fill() 時,開放的路徑會被自動閉合,因此不一定要先寫 closePath()。
一個最簡單的三角形就是這樣:
ctx.beginPath(); ctx.moveTo(75, 50); ctx.lineTo(100, 75); ctx.lineTo(100, 25); ctx.fill();
moveTo(x, y)
這個函式本身不畫任何東西,卻是路徑繪製中最實用的成員之一。你可以把它想成:把筆從紙面上抬起來,移到另一個點再落下。
它接受兩個參數,也就是新起點的座標。當 canvas 初始化或呼叫 beginPath() 後,起點會被設為 (0,0);多數情況下我們會用 moveTo 把起點挪到別處,或者用它畫出「互不相連」的多段路徑。
看看右邊那張笑臉——紅線標記處就是我使用 moveTo 的地方。
ctx.beginPath(); ctx.arc(75, 75, 50, 0, Math.PI*2, true); // 外圓 ctx.moveTo(110, 75); ctx.arc(75, 75, 35, 0, Math.PI, false); // 嘴巴(順時針) ctx.moveTo(65, 65); ctx.arc(60, 65, 5, 0, Math.PI*2, true); // 左眼 ctx.moveTo(95, 65); ctx.arc(90, 65, 5, 0, Math.PI*2, true); // 右眼 ctx.stroke();
把 moveTo 註解掉,你就能看到那些「本不該出現」的連接線。arc 函式的參數說明請見下節。
lineTo(x, y)
它接受終點座標 (x, y)。起點取決於前一段路徑——上一段的終點就是下一段的起點;当然也可以用 moveTo 重新指定起點。
// 填色三角形 ctx.beginPath(); ctx.moveTo(25, 25); ctx.lineTo(105, 25); ctx.lineTo(25, 105); ctx.fill(); // 描邊三角形 ctx.beginPath(); ctx.moveTo(125, 125); ctx.lineTo(125, 45); ctx.lineTo(45, 125); ctx.closePath(); ctx.stroke();
仔細比對會發現兩者差在「是否閉合」。填色的那個三角形即使只畫了兩條邊,看起來仍是完整的三角形,因為 fill() 會自動補上第三邊;而描邊的範例若省略 closePath(),就只會看到兩條線段。
arc(x, y, radius, startAngle, endAngle, anticlockwise)
五個參數裡,x 與 y 是圓心座標,radius 是半徑;startAngle 與 endAngle 以「弧度」為單位,且以 x 軸為基準度量;最後的 anticlockwise 是布林值,為 true 時逆時針繪製,否則順時針。
規格書裡另有 arcTo 方法,當時 Safari 已支援,而 Gecko 系瀏覽器尚未實作——這是歷史狀態,現代瀏覽器早已普及相關 API。
重點:角度单位是弧度,不是度數。換算方式:var radians = (Math.PI/180) * degrees;
如果照畫笑臉那樣把 12 個弧形一個個寫出來,程式碼會又長又難維護,而且每畫一個弧形都得先知道它的圓心位置。改用巢狀迴圈,事情就清爽多了:
for (i = 0; i < 4; i++) {
for (j = 0; j < 3; j++) {
ctx.beginPath();
var x = 25 + j * 50; // 圓心 x
var y = 25 + i * 50; // 圓心 y
var radius = 20; // 半徑
var startAngle = 0; // 起始角
var endAngle = Math.PI + (Math.PI * j) / 2; // 終止角
var anticlockwise = i % 2 == 0 ? false : true;
ctx.arc(x, y, radius, startAngle, endAngle, anticlockwise);
if (i > 1) {
ctx.fill();
} else {
ctx.stroke();
}
}
}
外層迴圈負責「列」,內層負責「行」。每個弧形都先 beginPath() 開新路徑,接著把參數抽成變數方便閱讀:x、y 決定圓心,radius 與 startAngle 固定,endAngle 從 180 度的半圓出發、每次遞增 90 度直到收攏成整圓;anticlockwise 依列數奇偶切換方向;最後用 if 判斷讓上半部描邊、下半部填色。
quadraticCurveTo(cp1x, cp1y, x, y)
bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y)
兩者的差異看圖最清楚:二次貝茲曲線有一個起點、一個終點(藍點)與一個控制點(紅點);三次貝茲曲線則動用兩個控制點。參數方面,x、y 永遠是終點座標,cp1x/cp1y 是第一個控制點,cp2x/cp2y 是第二個。
說實話,用貝茲曲線作畫頗具挑戰性——不像 Adobe Illustrator 那類向量軟體有即時的視覺回饋,你只能憑座標想像形狀。所以畫複雜圖形需要時間,更需要耐心。以下兩個範例都屬於「一連串曲線拼成完整圖形」的基礎手法。
// 二次曲線範例 ctx.beginPath(); ctx.moveTo(75, 25); ctx.quadraticCurveTo(25, 25, 25, 62.5); ctx.quadraticCurveTo(25, 100, 50, 100); ctx.quadraticCurveTo(50, 120, 30, 125); ctx.quadraticCurveTo(60, 120, 65, 100); ctx.quadraticCurveTo(125, 100, 125, 62.5); ctx.quadraticCurveTo(125, 25, 75, 25); ctx.stroke();
數學上,任何二次貝茲曲線都能正確換算成三次貝茲曲線(由單一控制點推導出兩個三次控制點),但反方向不成立:只有當三次項為零時才可能精確轉回二次;實務上多半改用「多段二次曲線逼近」的細分作法。
// 三次曲線範例 ctx.beginPath(); ctx.moveTo(75, 40); ctx.bezierCurveTo(75, 37, 70, 25, 50, 25); ctx.bezierCurveTo(20, 25, 20, 62.5, 20, 62.5); ctx.bezierCurveTo(20, 80, 40, 102, 75, 120); ctx.bezierCurveTo(110, 102, 130, 80, 130, 62.5); ctx.bezierCurveTo(130, 62.5, 130, 25, 100, 25); ctx.bezierCurveTo(85, 25, 75, 37, 75, 40); ctx.fill();
早期 Firefox 1.5 對 quadraticCurveTo() 的實作有 bug:它並未真正繪製二次曲線,而是把單一控制點重複傳給 bezierCurveTo(),結果自然不正確。若當時需要在該環境下使用二次曲線,只能自行換算成三次曲線再呼叫 bezierCurveTo():
var currentX, currentY; // 記錄最後一次傳給 moveTo/lineTo/bezierCurveTo/quadraticCurveTo 的座標
function quadraticCurveToFixed(cpx, cpy, x, y) {
// qp0 = 二次曲線起點(等於前一次 moveTo/lineTo/bezierCurveTo 的終點)
// qp1 = 二次曲線控制點(即 cpx, cpy)
// qp2 = 二次曲線終點(即 x, y)
//
// 換算公式:
// cp0 = qp0, cp3 = qp2
// cp1 = qp0 + 2/3 * (qp1 - qp0)
// cp2 = cp1 + 1/3 * (qp2 - qp0)
var cp1x = currentX + 2.0 / 3.0 * (cpx - currentX);
var cp1y = currentY + 2.0 / 3.0 * (cpy - currentY);
var cp2x = cp1x + (x - currentX) / 3.0;
var cp2y = cp1y + (y - currentY) / 3.0;
bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y);
currentX = x;
currentY = y;
}
rect(x, y, width, height)
除了前面三個「直接畫上去」的矩形函式,還有 rect() 是「把矩形加入路徑清單」,之後仍需 stroke() 或 fill() 才會顯示。x、y 為左上角座標,width、height 為寬高。呼叫它時,moveTo(0,0) 會被自動觸發,起點因此被重置回原點。
前面的範例每個圖形都只用了單一路徑函式,但 Canvas 完全不限制你能混用多少種、多少次。下面這個例子就把矩形、圓角矩形、arc、lineTo 與貝茲曲線全端上桌。
最值得注意的兩點是:自訂的 roundedRect 函式,以及 fillStyle 屬性。把複雜圖形封裝成自己的函式,能省下大約一半的程式碼;而 fillStyle 在這裡被用來把填色從預設的黑色切換成白色再切回黑色(這個屬性後續會深入說明)。
function draw() {
var ctx = document.getElementById('canvas').getContext('2d');
roundedRect(ctx, 12, 12, 150, 150, 15);
roundedRect(ctx, 19, 19, 150, 150, 9);
roundedRect(ctx, 53, 53, 49, 33, 10);
roundedRect(ctx, 53, 119, 49, 16, 6);
roundedRect(ctx, 135, 53, 49, 33, 10);
roundedRect(ctx, 135, 119, 25, 49, 10);
ctx.beginPath();
ctx.arc(37, 37, 13, Math.PI/7, -Math.PI/7, true);
ctx.lineTo(31, 37);
ctx.fill();
for (i = 0; i < 8; i++) { ctx.fillRect(51 + i*16, 35, 4, 4); }
for (i = 0; i < 6; i++) { ctx.fillRect(115, 51 + i*16, 4, 4); }
for (i = 0; i < 8; i++) { ctx.fillRect(51 + i*16, 99, 4, 4); }
ctx.beginPath();
ctx.moveTo(83, 116);
ctx.lineTo(83, 102);
ctx.bezierCurveTo(83, 94, 89, 88, 97, 88);
ctx.bezierCurveTo(105, 88, 111, 94, 111, 102);
ctx.lineTo(111, 116);
ctx.lineTo(106.333, 111.333);
ctx.lineTo(101.666, 116);
ctx.lineTo(97, 111.333);
ctx.lineTo(92.333, 116);
ctx.lineTo(87.666, 111.333);
ctx.lineTo(83, 116);
ctx.fill();
ctx.fillStyle = "white";
ctx.beginPath();
ctx.moveTo(91, 96);
ctx.bezierCurveTo(88, 96, 87, 99, 87, 101);
ctx.bezierCurveTo(87, 103, 88, 106, 91, 106);
ctx.bezierCurveTo(94, 106, 95, 103, 95, 101);
ctx.bezierCurveTo(95, 99, 94, 96, 91, 96);
ctx.moveTo(103, 96);
ctx.bezierCurveTo(100, 96, 99, 99, 99, 101);
ctx.bezierCurveTo(99, 103, 100, 106, 103, 106);
ctx.bezierCurveTo(106, 106, 107, 103, 107, 101);
ctx.bezierCurveTo(107, 99, 106, 96, 103, 96);
ctx.fill();
ctx.fillStyle = "black";
ctx.beginPath();
ctx.arc(101, 102, 2, 0, Math.PI*2, true);
ctx.fill();
ctx.beginPath();
ctx.arc(89, 102, 2, 0, Math.PI*2, true);
ctx.fill();
}
function roundedRect(ctx, x, y, width, height, radius) {
ctx.beginPath();
ctx.moveTo(x, y + radius);
ctx.lineTo(x, y + height - radius);
ctx.quadraticCurveTo(x, y + height, x + radius, y + height);
ctx.lineTo(x + width - radius, y + height);
ctx.quadraticCurveTo(x + width, y + height, x + width, y + height - radius);
ctx.lineTo(x + width, y + radius);
ctx.quadraticCurveTo(x + width, y, x + width - radius, y);
ctx.lineTo(x + radius, y);
ctx.quadraticCurveTo(x, y, x, y + radius);
ctx.stroke();
}