Canvas 最有趣的能力之一,就是能把圖片拉進來參與作畫。無論是動態合成照片、為圖表準備底圖,都能派上用場。在當年的規格裡,這甚至是往畫布上「加文字」的唯一途徑——因為規範本身並未提供繪製文字的函式。凡是 Gecko 支援的格式(PNG、GIF、JPEG 等)都能使用,同頁的其他 canvas 元素也可以當成素材來源。
drawImage() 把它畫到畫布上。第一步總共有四種常見做法。
透過 document.images 集合、document.getElementsByTagName(),或已知 id 時直接用 document.getElementById(),就能拿到頁面上任一張圖。
取用方式和普通圖片一樣。但要確保來源 canvas 已經畫好內容,否則你複製過去的就是一片空白。實務上最常見的用法,是為一個大 canvas 做縮圖預覽。
直接 new 一個 Image 物件即可:
var img = new Image(); // 建立新的 Image 物件 img.src = 'myImage.png'; // 設定來源路徑
腳本一執行,圖片就開始載入。如果 drawImage 被呼叫時圖還沒載完,程式會停下來等它載完——這通常不是我們想要的。避免的方式是掛上 onload:
var img = new Image(); // 建立新的 Image 物件
img.onload = function(){
// 在這裡執行 drawImage 相關程式
}
img.src = 'myImage.png'; // 設定來源路徑
只有一張外部圖時,這樣就夠了。但一旦要同時追蹤多張圖的載入狀態,就得換更聰明的策略。預載機制本身超出本篇範圍,有興趣可參考 JavaScript Image Preloader 這類完整方案。
你也可以把圖片以 Base64 編碼字串的形式直接寫進程式碼:
var img_src = 'data:image/gif;base64,R0lGODlhCwALAIAAAAAA3pn/ZiH5BAEAAAEALAAAAAALAAsAAAIUhA+hkcuO4lmNVindo7qyrIXiGBYAOw==';
優點是圖片立刻可用,不必再向伺服器多跑一趟;而且 CSS、JavaScript、HTML 與圖片能全部封裝在同一個檔案裡,搬遷格外方便。缺點是這種圖片不會被快取,圖越大、內嵌的網址字串就越長。
image 是圖片或 canvas 的參照,x、y 則是它在目標畫布上的落點座標。
有了底圖,就不必用程式硬畫一張複雜背景,程式碼立刻瘦身。這裡只有一張圖,所以把繪製動作放進它的 onload 裡;drawImage(img, 0, 0) 會把底圖釘在畫布左上角。
function draw() {
var ctx = document.getElementById('canvas').getContext('2d');
var img = new Image();
img.onload = function(){
ctx.drawImage(img, 0, 0);
ctx.beginPath();
ctx.moveTo(30, 96);
ctx.lineTo(70, 66);
ctx.lineTo(103, 76);
ctx.lineTo(170, 15);
ctx.stroke();
}
img.src = 'images/backdrop.png';
}
多出來的 width 與 height,就是圖片在目標畫布上的顯示尺寸。
把同一張圖縮小後,用迴圈在畫布上重複鋪排,就能做出圖案式的背景。外層迴圈跑列、內層跑行;範例中圖片被縮到原本的三分之一,也就是 50×38 像素。後續章節會示範用自訂 pattern 達成同樣效果。
function draw() {
var ctx = document.getElementById('canvas').getContext('2d');
var img = new Image();
img.onload = function(){
for (i = 0; i < 4; i++) {
for (j = 0; j < 3; j++) {
ctx.drawImage(img, j*50, i*38, 50, 38);
}
}
}
img.src = 'images/rhino.jpg';
}
提醒:放大過多會模糊,縮小過多會出現雜點。若圖裡含有需要保持可讀的文字,最好不要縮放。
最後一種形態有八個參數。前四個定義「來源圖上要切下的區域」的位置與大小(sx、sy、sWidth、sHeight),後四個定義「貼到目標畫布上」的位置與大小(dx、dy、dWidth、dHeight)。第一個參數一如往常,是圖片或另一個 canvas 的參照。
切片是做合成的利器。你可以把所有素材收在一張圖檔裡,再視需要拼出不同畫面。舉例來說,做圖表時可以準備一張包含全部所需文字的 PNG,依實際數據調整最終呈現的大小,而且不必逐一載入每個小圖。
沿用前面的犀牛圖,這次把它的頭部切出來,合成到一個相框裡。相框圖存成 24-bit PNG,因為它帶有完整的 8-bit alpha 通道(有別於 GIF 與 8-bit PNG),放到任何背景上都不用擔心底色。
這次換個載入方式:直接把兩張圖放進 HTML,用 CSS 的 display:none 藏起來,並各給一個 id 方便選取。腳本本身很單純——先畫切片並縮放,再疊上相框。
function draw() {
var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');
// 畫切片
ctx.drawImage(document.getElementById('source'),
33, 71, 104, 124, 21, 20, 87, 104);
// 畫相框
ctx.drawImage(document.getElementById('frame'), 0, 0);
}
最後做一個小型藝廊:頁面上有一張放著若干圖片的表格,頁面載入時,腳本會為每張圖動態插入一個 canvas 元素,並在圖周圍畫上相框。
這裡所有圖片與相框都是固定尺寸。你当然可以改進它,改成讀取圖片實際的 width 與 height,讓相框自動贴合。
程式邏輯是走訪 images 陣列、逐一補上 canvas。對 DOM 不熟的人,唯一需要留意的是 insertBefore:它是「父節點」的方法(此例中是表格儲存格),用來把新節點(canvas)插入到某個既有子節點(圖片)之前。
function draw() {
// 走訪所有圖片
for (i = 0; i < document.images.length; i++) {
// 相框圖本身不處理
if (document.images[i].getAttribute('id') != 'frame') {
// 建立 canvas 元素
canvas = document.createElement('CANVAS');
canvas.setAttribute('width', 132);
canvas.setAttribute('height', 150);
// 插入到圖片之前
document.images[i].parentNode.insertBefore(canvas, document.images[i]);
ctx = canvas.getContext('2d');
// 把圖片畫進 canvas
ctx.drawImage(document.images[i], 15, 20);
// 疊上相框
ctx.drawImage(document.getElementById('frame'), 0, 0);
}
}
}