Canvas 是 HTML5 最具代表性的繪圖能力。本文以「畫一棵樹」為主線,依序走過 Canvas 2D Context 的每一類核心 API:路徑、描邊與填充、矩形、曲線、圖片、漸層、平鋪模式、變換、文字、陰影,最後是像素級操作。
<script type="text/javascript">
try {
document.createElement('canvas').getContext('2d');
document.getElementById('support').innerHTML = 'OK';
} catch (e) {
document.getElementById('support').innerHTML = e.message;
}
</script>
<canvas id="diagonal" style="border:1px solid blue;" width="200" height="200"></canvas>
<script>
var canvas = document.getElementById('diagonal');
var context = canvas.getContext('2d');
// 用絕對座標建立路徑
context.beginPath();
context.moveTo(70, 140);
context.lineTo(140, 70);
// 把這條線真的畫到 canvas 上
context.stroke();
</script>
這裡有個關鍵觀念:beginPath 到 stroke 之間只是「定義路徑」,畫面實際改變是在 stroke() 或 fill() 被呼叫時才發生。
var canvas = document.getElementById('diagonal');
var context = canvas.getContext('2d');
context.save(); // 保存目前繪圖狀態
context.translate(70, 140); // 把原點移到 (70, 140)
context.beginPath();
context.moveTo(0, 0);
context.lineTo(70, -70);
context.stroke();
context.restore(); // 還原繪圖狀態
save() 與 restore() 是一組成對使用的工具:前者把目前的畫布狀態(含變換矩陣、樣式設定)壓入堆疊,後者彈出還原。養成這個習慣,才能避免上一段程式的變換污染到下一段。
beginPath():不帶參數,用來通知 canvas「要開始畫一個新圖形了」。任何繪圖的第一個呼叫都應該是它。moveTo(x, y):不產生線條,只把目前位置移到新的座標。lineTo(x, y):把目前位置移到新座標,並在兩點之間畫一条直线。closePath():行為近似 lineTo,但目標點自動設為路徑起點,同時標記圖形已閉合。這對後續的填充與描邊非常重要。function createCanopyPath(context) {
context.beginPath();
// 左半側,一層一層往上收
context.moveTo(-25, -50);
context.lineTo(-10, -80);
context.lineTo(-20, -80);
context.lineTo(-5, -110);
context.lineTo(-15, -110);
// 樹尖
context.lineTo(0, -140);
// 右半側,鏡像而下
context.lineTo(15, -110);
context.lineTo(5, -110);
context.lineTo(20, -80);
context.lineTo(10, -80);
context.lineTo(25, -50);
context.closePath();
}
function drawTrails() {
var canvas = document.getElementById('diagonal');
var context = canvas.getContext('2d');
context.save();
context.translate(130, 250);
createCanopyPath(context);
context.stroke();
context.restore();
}
window.addEventListener('load', drawTrails, true);
context.lineWidth = 4; // 加寬線條
context.lineJoin = 'round'; // 讓轉折處平滑
context.strokeStyle = '#663300'; // 線條顏色
context.stroke();
context.fillStyle = '#339900';
context.fill();
矩形是唯一有專用捷徑的圖形,不必經過路徑:
context.fillStyle = '#663300';
context.fillRect(-5, -50, 10, 50); // 加上樹幹
對應的還有 strokeRect(x, y, w, h) 只描邊,以及 clearRect() 清除指定區域。
context.save();
context.translate(-10, 350);
context.beginPath();
// 第一段:向右上方彎
context.moveTo(0, 0);
context.quadraticCurveTo(170, -50, 260, -190);
// 第二段:接著向右下方彎
context.quadraticCurveTo(310, -250, 410, -250);
// 用粗咖啡色描邊
context.strokeStyle = '#663300';
context.lineWidth = 20;
context.stroke();
context.restore();
quadraticCurveTo(cpx, cpy, x, y) 是二次貝茲曲線,需要一個控制點;若要更細緻的控制,可用 bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y) 三次貝茲曲線,兩個控制點。而 arcTo() 則適合畫「轉角圓弧」這類需求。
最容易被忽略的陷阱:圖片是等非同步載入的。如果在圖片尚未載入完成前就嘗試把它畫到 canvas 上,畫面上什麼都不會出現,而且不會報錯。因此務必在 onload 裡才進行繪圖。
// 載入圖片
var bark = new Image();
bark.src = 'bark.jpg';
// 圖片載入完成後,才呼叫繪圖函式
bark.onload = function () {
drawTrails();
};
// 在 drawTrails 內部,用樹皮圖當作樹幹的填色
context.drawImage(bark, -5, -50, 10, 50);
drawImage 有三種簽章:drawImage(img, dx, dy) 原尺寸貼上、drawImage(img, dx, dy, dWidth, dHeight) 指定目標尺寸(本例用的就是這個),以及 drawImage(img, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight) 可做裁切後再縮放,是實作精靈圖動畫的基礎。
使用漸層分為三個步驟:
fillStyle 或 strokeStyle。// 1. 建立作為樹幹紋理的水平三階漸層
var trunkGradient = context.createLinearGradient(-5, -50, 5, -50);
// 2. 設定顏色停靠點:offset 介于 0 到 1 之間
trunkGradient.addColorStop(0, '#663300'); // 左緣:普通棕色
trunkGradient.addColorStop(0.4, '#996600'); // 偏左:亮一些
trunkGradient.addColorStop(1, '#552200'); // 右緣:深一些
// 3. 指派並填色
context.fillStyle = trunkGradient;
context.fillRect(-5, -50, 10, 50);
// 再來做一個垂直漸層,模擬樹冠投影在樹幹上的陰影
var canopyShadow = context.createLinearGradient(0, -50, 0, 0);
canopyShadow.addColorStop(0, 'rgba(0, 0, 0, 0.5)'); // 起點:半透明黑
canopyShadow.addColorStop(0.2, 'rgba(0, 0, 0, 0.0)'); // 短距離內淡出
context.fillStyle = canopyShadow;
context.fillRect(-5, -50, 10, 50);
第二組漸層的巧思在於 addColorStop 的 offset 只用了 0 到 0.2:這代表陰影在很短的距離內就完全淡出,0.2 之後的樹幹保持原色,看起來就像樹冠只在上方投下一小片影子。
var gravel = new Image();
gravel.src = 'gravel.jpg';
gravel.onload = function () {
drawTrails();
};
// 用平鋪圖案取代原本的棕色粗線
context.strokeStyle = context.createPattern(gravel, 'repeat');
context.lineWidth = 20;
context.stroke();
createPattern 的第二個參數決定平鋪方式:
repeat(預設):水平與垂直雙向平鋪。repeat-x:僅水平平鋪。repeat-y:僅垂直平鋪。no-repeat:只顯示一次,不平鋪。// 在 (130, 250) 畫第一棵樹
context.save();
context.translate(130, 250);
drawTree(context);
context.restore();
// 在 (260, 500) 畫第二棵樹,尺寸放大為兩倍
context.save();
context.translate(260, 500);
context.scale(2, 2);
drawTree(context);
context.restore();
scale(x, y) 的兩個參數分別代表在該軸上的放大倍率:x 為 2 表示所有元素寬度變兩倍,y 為 0.5 則表示高度縮為一半。要注意的是縮放會連線寬一起放大——這正是另一篇「橢圓線條不均勻」問題的成因,解法是在 restore() 之後才 stroke()。
context.save();
// 參數以弧度為單位,1.57 弧度約為 90 度
context.rotate(1.57);
context.drawImage(myImage, 0, 0, 100, 100);
context.restore();
記住換算關係:弧度 = 度數 × π ÷ 180。90° 是 π/2 ≈ 1.5708,180° 是 π ≈ 3.1416,360° 是 2π。
context.save();
// X 值隨 Y 值增加而增加,做出傾斜變形,用來畫影子
context.transform(1, 0,
-0.5, 1,
0, 0);
// Y 軸方向壓扁為 60%
context.scale(1, 0.6);
// 以 20% 不透明度的黑色填充樹幹
context.fillStyle = 'rgba(0, 0, 0, 0.2)';
context.fillRect(-5, -50, 10, 50);
// 重用樹冠路徑,畫出影子
createCanopyPath(context);
context.fill();
context.restore();
transform(a, b, c, d, e, f) 直接以矩陣運算的方式改造座標系統,比 translate/rotate/scale 這些預設組合更靈活。上例中 c = -0.5 讓 X 座標受到 Y 座標牽引,於是垂直的樹幹被「拉斜」成影子。另有 setTransform() 可直接重設矩陣,不受目前狀態影響。
// 填充文字
context.fillText(text, x, y, maxwidth);
// 只描邊的文字
context.strokeText(text, x, y, maxwidth);
maxwidth 是可選參數,用來限制文字的最大寬度(必要時會壓縮字距)。實際使用:
context.save();
context.font = '60px impact'; // 字號與字型
context.fillStyle = '#996600';
context.textAlign = 'center'; // 水平對齊
context.fillText('Happy Trails!', 200, 60, 400);
context.restore();
對齊相關的屬性還有 textBaseline(控制垂直基準線,可設 top、middle、bottom 等)。若想量測文字寬度以便配置版面,用 context.measureText(str).width。
透過四個全域屬性即可控制陰影:
shadowColor:任何合法的 CSS 顏色值,可帶 alpha 透明度。shadowOffsetX:像素值,正值向右、負值向左。shadowOffsetY:像素值,正值向下、負值向上。shadowBlur:高斯模糊程度,數值越大邊緣越模糊。context.shadowColor = 'rgba(0, 0, 0, 0.2)';
context.shadowOffsetX = 15;
context.shadowOffsetY = -10;
context.shadowBlur = 2;
實務上要留意:陰影開啟會明顯拖慢繪圖效能,動畫中大量使用容易造成掉幀,用完記得重設為 'transparent' 或 'none'。
context.getImageData(sx, sy, sw, sh);
參數意義為起始座標 (sx, sy) 與要擷取區域的寬 sw、高 sh。回傳的 ImageData 物件有三個屬性:
width:這塊區域有多少像素寬。height:有多少像素高。data:一個一維陣列,依序存放每個像素的 R、G、B、A 四個數值(各 0–255)。注意 data 的長度是 width × height × 4,而不是 width × height;要知道第 y 列第 x 個像素的紅色值,索引是 (y * width + x) * 4。
context.putImageData(imagedata, dx, dy);
傳入一組 ImageData,並以 (dx, dy) 指定要更新到 canvas 的哪個位置。這組 API 是實作灰度化、色彩濾鏡、邊緣偵測等影像處理效果的唯一途徑。
canvas.toDataURL();
可取得 canvas 目前畫面的資料 URL,本質上是一段 base64 編碼的字串,能直接指定給 <img> 的 src,或送到伺服器存檔。若要指定格式與品質,可用 canvas.toDataURL('image/jpeg', 0.8)。想一口氣大量擷取則可改用 canvas.toBlob(),效能與記憶體使用都更好。
把這些 API 串起來就能得到一個完整的 Canvas 應用:路徑決定形狀,描邊與填充決定外觀,變換決定位置與姿態,漸層與圖案提供質感,陰影營造層次,最後用像素操作做特殊後製。真正的門檻不在 API 記不記得住,而在於能否熟練地以 save() / restore() 管理狀態,讓每一段繪圖邏輯彼此獨立、互不干擾。