以下把 Canvas 開發中容易踩到的細節整理成 20 條,從基本設定到變形矩陣都有涵蓋,適合當作開發時的速查清單。官方中文教學文件可參考 MDN 的 Canvas 教學章節。
若不指定,畫布會以這個尺寸建立。要避免版面異常,建議直接用 HTML 的 width 與 height 屬性設定,而不要用 CSS 控制。兩者的意義不同:HTML 屬性決定的是繪圖表面的實際像素數,CSS 決定的只是顯示大小。若用 CSS 放大,畫面會被拉伸模糊,而且座標換算也會出錯。
可以在 <canvas> 標籤內部放入替代內容,不支援 Canvas 的瀏覽器會直接顯示這段文字:
<canvas id="tutorial">您的瀏覽器不支援 Canvas,請更新瀏覽器版本。</canvas>
var canvas = document.getElementById('tutorial');
if (canvas.getContext) {
var ctx = canvas.getContext('2d');
// 繪圖程式碼
} else {
// 不支援時的處理
}
Canvas 內建的快速形狀只有矩形,其他任何圖形都要靠路徑(path)拼出來。
rect 建立路徑、fillRect 填滿、strokeRect 描邊、clearRect 清空。前三者最大的差別在於 rect 只是定義路徑,實際畫出來還需要再呼叫 fill 或 stroke。
beginPath() 的作用是開啟一個全新的路徑層。少了它,新的線段會接在上一段後面。下面兩段代碼視覺結果完全不同:
// 不中斷路徑:兩段線共用同一次 stroke,第二段的顏色設定來不及生效
var ctx = document.getElementById('cvs').getContext('2d');
ctx.beginPath();
ctx.moveTo(100.5, 20.5);
ctx.lineTo(200.5, 20.5);
ctx.stroke();
ctx.moveTo(100.5, 40.5);
ctx.lineTo(200.5, 40.5)
ctx.strokeStyle = '#f00';
ctx.stroke();
// 正確中斷:各自 stroke,顏色分別生效
var ctx = document.getElementById('cvs').getContext('2d');
ctx.beginPath();
ctx.moveTo(100.5, 20.5);
ctx.lineTo(200.5, 20.5);
ctx.stroke();
ctx.beginPath();
ctx.moveTo(100.5, 40.5);
ctx.lineTo(200.5, 40.5)
ctx.strokeStyle = '#f00';
ctx.stroke();
不需要閉合時可以省略。而且如果後面接的是 fill(),路徑會自動閉合,再呼叫 closePath() 反而是多此一舉。
只要有足夠的耐心調整控制點,二次與三次貝茲曲線可以組合出任意輪廓。
Firefox 的 quadraticCurveTo 曾有實作上的缺陷,實務上可以改用三次曲線 bezierCurveTo 來規避。
PNG、GIF、JPEG 等圖片可以放進 Canvas,而且另一個 Canvas 元素也能直接當成繪圖來源,這是快取機制得以成立的基礎。
// 基本繪製:image 為 img 或 canvas 物件,(x, y) 為目標起始座標
drawImage(image, x, y);
// 縮放繪製:width、height 為目標尺寸
drawImage(image, x, y, width, height);
// 裁剪繪製
drawImage(image, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight);
九參數版本中,前四個 (sx, sy, sWidth, sHeight) 描述「從來源圖的哪個區域取」;後四個 (dx, dy, dWidth, dHeight) 描述「畫到目標的哪個位置、多大」。兩組尺寸不必相同,不同時就會自動縮放,這是做縮圖與精靈圖動畫的關鍵。
前者設定輪廓顏色,後者設定填充顏色。可接受的格式包含 CSS 顏色字串、漸層物件與圖案物件。兩者預設值都是黑色(#000000)。
可以用 globalAlpha = 0.5 全域設定,也可以用 rgba() 顏色值針對單一圖形設定。前者會影響後續所有繪製直到被改回,使用時要留意狀態延續。
因為 Canvas 支援半像素繪製並會自動插值,當線寬為 1px 且座標落在整數上時,線條會横跨兩個像素而顯得模糊。解法是讓座標加 0.5,例如畫在 100.5 而不是 100。
三種取值:butt(預設,端點平齊)、round(端點加上半圓,半徑為線寬一半)、square(端點加上等寬方塊,高度為線寬一半)。
round 把轉角磨圓、bevel 削成斜面、miter 則讓兩側線段向外延伸交於一點。尖銳的 miter 轉角可能拉得很長,需要用 miterLimit 限制延伸比例。
這兩個方法保存與還原 Canvas 的完整狀態快照,包含所有樣式設定與變形矩陣。狀態以堆疊方式存放:每次 save() 把目前狀態壓入,每次 restore() 把最近一次存下的彈出還原。組合多層變形時,用它們收尾比手動反向操作可靠得多。
transform(a, b, c, d, e, f);
依序代表:水平縮放、水平方向傾斜(順時針)、垂直方向傾斜(逆時針)、垂直縮放、水平位移、垂直位移。transform 是「在現有矩陣上再乘」,setTransform 則是先重置再套用新矩陣,參數意義相同但效果不同。
一個半徑為 1 的圓周長為 2π,對應 360 度,換算關係為:弧度 = 度數 × π / 180。因此 90 度要寫成 Math.PI / 2,30 度寫成 Math.PI / 6。
Canvas 沒有保留模式(retained mode)的概念,畫上去的像素不會自己消失。因此每一幀的標準流程是:clearRect() 清掉整個畫布,重新計算所有物件的新位置,再全部畫一次。搭配 requestAnimationFrame 而非 setInterval,可以讓畫面更新與瀏覽器重繪時機對齊,較不容易出現撕裂或掉格。