用 Canvas 的 drawImage 畫圖很直覺,但一旦牽涉到縮放與多張圖片,就容易遇到難以理解的行為。這裡記錄一個實際踩到的案例。
先取得 canvas 與內容,再建立 image 物件(可以用既有的 img 標籤,也可以 new 一個),設定 src 與 onload:
var canvas = document.getElementById("test");
var ctx = canvas.getContext("2d");
var img = new Image();
img.src = "images/img.png";
img.onload = function(){
ctx.drawImage(img, 0, 0);
}
要縮放,加上 ctx.scale(2, 2) 就好。到這裡一切正常。
需求是在畫布不同位置顯示同一張圖,一處縮小、一處維持原尺寸。於是很自然地寫成:
var img = new Image();
img.src = "images/img.png";
img.onload = function(){
ctx.drawImage(img, 0, 0);
}
ctx.scale(0.2, 0.2)
var img = new Image();
img.src = "images/img.png";
img.onload = function(){
ctx.drawImage(img, 10, 10);
}
結果卻是:第一張圖偶爾也被縮成 0.2 倍。
問題出在 onload 的執行時機。onload 是在圖片載入完成時才觸發,而我們無法確定第一張圖是在 ctx.scale(0.2, 0.2) 之前還是之後才載入完。若在之後,它自然就被縮小了。第二張圖之所以沒事,是因為 scale 在它的 onload 註冊前就已設定完成。
換句話說,這不是 Canvas 的 bug,而是非同步執行的順序問題。
把 scale 移進 onload 內部,讓它與繪製動作處於同一個時序;再用 save/restore 把變換效果限制在這次繪製裡,不影響其他圖:
var img = new Image();
img.src = "images/img.png";
img.onload = function(){
ctx.drawImage(img, 0, 0);
}
var img2 = new Image();
img2.src = "images/img.png";
img2.onload = function(){
ctx.save();
ctx.scale(0.2, 0.2)
ctx.drawImage(img2, 10, 10);
ctx.restore();
}
另外還有兩個細節值得注意:兩段程式碼原本都宣告了 var img,在同一個作用域裡這會互相覆蓋,應改用不同變數名;而 scale 是「乘算」到後續所有繪圖上的,若不想改動座標系,更乾淨的做法是直接用 drawImage 的完整參數在目標尺寸上做縮放,完全不動 transform。