寫 Canvas 的人大概都遇過這件怪事:明明設了 lineWidth = 1,畫出來的線卻看起來粗粗糊糊的,跟一般網頁上那種銳利清爽的細線完全不是一回事。
ctx.lineWidth = 1;
ctx.beginPath();
ctx.moveTo(10, 100);
ctx.lineTo(300, 100);
ctx.stroke();
這是 Canvas 的 bug 嗎?其實不是,而是它的座標與填色規則使然。
Canvas 的像素格線落在整數座標上,而 1 像素寬的線並不是「以座標為中心、左右各 0.5」的方式繪製,而是從座標往一側佔滿 0~1 的範圍。當你告訴它從 y = 100 開始畫,它實際上佔據的是 y = 100 到 101 這一整格,邊緣因此落在兩個像素的交界上,瀏覽器只好用抗鋸齒(fade)把線「抹」到兩側,視覺上就成了兩像素寬的模糊線條。
最簡潔的做法是把整個座標系平移半個像素,讓線條剛好落在像素格的正中央:
ctx.save();
ctx.translate(0.5, 0.5);
ctx.lineWidth = 1;
ctx.beginPath();
ctx.moveTo(10, 100);
ctx.lineTo(300, 100);
ctx.stroke();
ctx.restore();
這裡有一個容易踩到的前提:所有座標都必須是整數。如果座標本身帶小數,Canvas 一樣會啟動邊緣抗鋸齒,線條看起來又會變粗變虛。位移 0.5 是為了對齊像素中心,而端點座標仍應保持整數。
另一條路子是先用較粗的線畫一次,再用工背景色蓋掉多餘的一半。我把這個思路包裝成了 CanvasRenderingContext2D 的擴充方法,用起來就跟原生 API 一樣:
/**
* 畫一條真正一像素寬的線
* @param fromX 起點 x
* @param fromY 起點 y
* @param toX 終點 x
* @param toY 終點 y
* @param backgroundColor 背景色,預設白色
* @param vertical 是否為垂直線(boolean)
*/
CanvasRenderingContext2D.prototype.onePixelLineTo = function(fromX, fromY, toX, toY, backgroundColor, vertical) {
var currentStrokeStyle = this.strokeStyle;
// 先畫 2px 的線
this.beginPath();
this.moveTo(fromX, fromY);
this.lineTo(toX, toY);
this.closePath();
this.lineWidth = 2;
this.stroke();
// 再用背景色蓋掉多出來的一半
this.beginPath();
if (vertical) {
this.moveTo(fromX + 1, fromY);
this.lineTo(toX + 1, toY);
} else {
this.moveTo(fromX, fromY + 1);
this.lineTo(toX, toY + 1);
}
this.closePath();
this.lineWidth = 2;
this.strokeStyle = backgroundColor;
this.stroke();
// 還原原本的 strokeStyle,避免影響後續繪製
this.strokeStyle = currentStrokeStyle;
};
這個方法要注意兩件事:一是它依賴背景色,背景帶漸層或影像時就不適用;二是結尾務必還原 strokeStyle,否則會污染後面的繪圖狀態。
單純的純色背景、大量密集的網格線,錯位覆蓋法很夠用;但只要畫布背景不單純,或是需要搭配 save/restore 管理狀態,中心平移法都更省心。這兩招說穿了都是為了對齊像素格線,理解背後的原因,比背下結論更有價值。