Canvas 是 HTML5 進行二維繪圖的核心工具。本文把常用的 Canvas 2D context 方法整理成一份可隨查的參考手冊,方便開發時對照使用。
canvas.getContext('2d'):無法直接在 canvas 上繪圖,必須先呼叫此方法取得二維繪圖上下文。
context.beginPath():開始一條新路徑。
context.isPointInPath(x, y):判斷某點是否落在路徑上(座標系被轉換後不適用)。
context.moveTo(x, y):好比把畫筆提起再定位到 (x, y),從新位置開始繪製,不產生線段。
context.lineTo(x, y):畫筆不離開畫板,從當前點畫一條線到 (x, y)。
context.closePath():行為近似 lineTo,但終點自動回到路徑起點,並通知 Canvas 目前圖形已閉合,便於後續填色與描邊。此後可繼續畫出更多子路徑,或隨時 beginPath 全部清空重來。
context.rect(x, y, w, h):在 (x, y) 處畫出寬 w、高 h 的矩形;當前點被忽略,但繪製完後 (x, y) 成為新的當前點。
context.arc(x, y, radius, startAngle, endAngle, anticlockwise):繪製圓弧。x、y 為圓心,radius 為半徑,start/end 為起訖弧度(0 弧度朝右,π 以 Math.PI 表示),anticlockwise 為可選布林值,true 逆時針、false 順時針(預設)。使用它可省略 lineTo。
context.arcTo(x1, y1, x2, y2, radius):以當前點、(x1,y1)、(x2,y2) 建構兩條切線,畫出與兩線相切、半徑為 radius 且位於指定象限內的圓弧,常用於繪製圓角矩形。
context.quadraticCurveTo(x1, y1, x2, y2):從當前點到 (x2,y2) 畫一段二次貝茲曲線,彎曲度由控制點 (x1,y1) 決定(控制點不在曲線上)。
context.bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y):從當前點到 (x,y) 畫一段由兩個控制點決定的三次貝茲曲線。
context.stroke():真正把路徑描邊顯示出來。
context.fill():在設定填充樣式後填滿閉合路徑,呼叫後不需再 stroke。
context.fillRect(x, y, width, height):在 (x, y) 處繪製並填滿指定大小的矩形。
context.strokeRect(x, y, width, height):在 (x, y) 處繪製指定大小的矩形輪廓。
context.clearRect(x, y, width, height):清除矩形區域並重置為透明,是製作動畫與遊戲的關鍵;若要流暢,通常還需搭配剪裁或第二塊緩衝畫布來減少閃爍。
context.clip():依上一次的閉合路徑建立剪輯區,之後繪製的內容只有落在區內的部分才會顯示,形同一層遮罩。
context.save():保存畫布當前狀態;之後任何改變,都能用 restore 還原。實務上應在每段新繪製前 save、結束後 restore,因為許多屬性以堆疊形式保存狀態。
context.restore():還原到上一次 save 的狀態。
context.translate(x, y):把座標原點移到 (x, y)。
context.scale(xMultiple, yMultiple):設定 x、y 向的縮放倍率,大於 1 放大、介於 0 到 1 縮小,負值可做出倒影或翻轉。
context.rotate(angle):以當前原點為中心旋轉 context,單位為弧度,正值順時針、負值逆時針。
context.transform(ScaleX, skewY, skewX, ScaleY, transX, transY):以變換矩陣控制大小、切變與位移,會與先前的變換複合。
context.setTransform(ScaleX, skewY, skewX, ScaleY, transX, transY):類似 transform,但從原始狀態套用變換、不與先前複合;常用 setTransform(1,0,0,1,0,0) 把狀態歸零。
context.drawImage():有多個重載,可把 img、另一個 canvas 或 video 的一幀畫到畫布上。
// 在 (x, y) 處原尺寸繪圖 context.drawImage(img, x, y); // 縮放為 (w, h) 後繪製 context.drawImage(img, x, y, w, h); // 裁剪來源 (imgx, imgy, imgw, imgh),繪於目標 (cx, cy, cw, ch) context.drawImage(img, imgx, imgy, imgw, imgh, cx, cy, cw, ch); // 以 video 的某一幀作為來源 context.drawImage(video, vx, vy, vw, vh, cx, cy, cw, ch);
context.getImageData(x, y, width, height):取得一塊像素區域,回傳含 width、height、data 三屬性的 ImageData;data 為一維陣列,每四個元素依序代表一個像素的 RGBA。
context.createImageData(w, h):建立一塊新的 ImageData。
context.putImageData(ImageData, x, y, x1, y1, w, h):把 ImageData 繪到 (x, y),後四參數為可選的裁剪矩形。
context.createLinearGradient(x1, y1, x2, y2):在兩點之間建立線性漸變。
context.createRadialGradient(x0, y0, r0, x1, y1, r1):在兩圓之間建立放射狀漸變。
gradient.addColorStop(offset, color):在漸變線上 offset(0.0 到 1.0)處設定顏色,color 可用 rgba() 做出透明漸變。
context.createPattern(img, repeatPattern):用圖像建立可重複的樣式,repeatPattern 可取 repeat、repeat-x、repeat-y、no-repeat。
fillText(text, x, y, maxwidth):在 (x, y) 繪製填充文字,可搭配 font、fillStyle、textAlign。
strokeText(text, x, y, maxwidth):在 (x, y) 繪製描邊文字,可搭配 font、textAlign、lineWidth、strokeStyle。
context.measureText("text"):依當前 font、textAlign、textBaseline 計算文字佔用區域,回傳目前僅含 width 屬性的 TextMetrics 物件。
canvas.toDataURL(type, args):把 canvas 轉為 Base64 編碼的圖像,預設為 png;type 可指定 image/jpeg 等,args 可於 jpeg 時傳入 0.0 到 1.0 的品質值。
var canvas = document.getElementById("myCanvas");
window.open(canvas.toDataURL("image/png"));