Canvas 與 Image 之間的轉換,是做圖片處理、浮水印、縮圖、滤镜效果時一定會用到的基本工。好消息是這兩件事都只要幾行程式碼。
關鍵是 canvas 的 drawImage() 方法:
// 把 image 轉成 canvas,回傳新的 canvas 元素
function convertImageToCanvas(image) {
var canvas = document.createElement("canvas");
canvas.width = image.width;
canvas.height = image.height;
canvas.getContext("2d").drawImage(image, 0, 0);
return canvas;
}
這裡的 0, 0 是畫布上的座標點,代表圖片會被貼到左上角。drawImage 還有更完整的五參數與九參數版本,可以指定「只取原圖的某個區塊」以及「縮放到指定大小」:
// 五參數:貼到 (dx, dy),並縮放成 dWidth × dHeight
ctx.drawImage(image, dx, dy, dWidth, dHeight);
// 九參數:先從原圖裁 (sx, sy, sWidth, sHeight),再貼到 (dx, dy) 並縮放
ctx.drawImage(image, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight);
作品畫完之後,用 toDataURL() 就能把畫布內容轉成圖片資料:
// 把 canvas 轉成 image
function convertCanvasToImage(canvas) {
var image = new Image();
image.src = canvas.toDataURL("image/png");
return image;
}
一行 toDataURL("image/png") 就把整個畫布編碼成 PNG 的 Base64 Data URL,指定到 image 的 src 上就得到一張真正的圖片物件了。
格式可選。toDataURL() 支援 image/png、image/jpeg,部分瀏覽器還支援 image/webp。JPEG 可以傳第二個參數指定品質(0 到 1 之間的小數),PNG 則會忽略該參數。
想直接下載而不是塞進頁面?把 Data URL 掛到 <a> 的 href 上,加上 download 屬性觸發點擊即可:
var link = document.createElement('a');
link.download = 'output.png';
link.href = canvas.toDataURL('image/png');
link.click();
如果圖片較大,Data URL 的字串會很長,某些舊瀏覽器有長度限制,這時改用 canvas.toBlob() 產生 Blob 再搭配 URL.createObjectURL() 會更穩健,也比較省記憶體。
最大的地雷:跨來源汙染(tainted canvas)。如果你 drawImage 進來的圖片來自其他網域,而該伺服器沒有回覆適當的 CORS 標頭,畫布就會被標記為「汙染」,此時呼叫 toDataURL() 或 getImageData() 會直接丟出安全性錯誤。解法有兩個:在 <img> 上先設 crossOrigin = "anonymous",並由圖片伺服器提供 Access-Control-Allow-Origin;或者乾脆把圖片放到自己的同來源主機上。這個問題在處理使用者上傳以外的外部圖片時幾乎一定會遇到,先知道能省下不少排查時間。
掌握這兩個方向的轉換之後,縮圖、加水印、裁切頭像、加上滤镜再輸出等需求,基本上都只是「畫進去 → 處理 → 存出來」這條流水線的排列組合而已。