遊戲裡常需要同一張素材換不同顏色——同一個圖示,紅色代表血量、藍色代表魔力。與其請設計師畫好幾版,不如在執行期直接改像素。本文示範如何用 Canvas 的 getImageData / putImageData 做精準的顏色替換。
getImageData 把整張圖的像素資料讀成陣列。putImageData 寫回。<canvas id="c1" width="1220" height="880"
style="background: none repeat scroll 0% 0% transparent;"></canvas>
<script>
var cID = "c1";
var image = new Image();
image.src = "Eye/item_eye_1.png";
image.onload = function () {
// 把純黑色 (0,0,0) 換成純綠色 (0,255,0)
recolorImage(cID, image, 0, 0, 0, 255, 0, 0);
};
function recolorImage(c, img, oldRed, oldGreen, oldBlue,
newRed, newGreen, newBlue) {
var c = document.getElementById(c);
var ctx = c.getContext("2d");
var w = img.width, h = img.height;
c.width = w;
c.height = h;
// 先把原圖畫上去
ctx.drawImage(img, 0, 0, w, h);
// 把整張圖的像素讀進陣列
var imageData = ctx.getImageData(0, 0, w, h);
// 逐一檢查每個像素
for (var i = 0; i < imageData.data.length; i += 4) {
if (imageData.data[i] == oldRed &&
imageData.data[i + 1] == oldGreen &&
imageData.data[i + 2] == oldBlue) {
imageData.data[i] = newRed;
imageData.data[i + 1] = newGreen;
imageData.data[i + 2] = newBlue;
}
}
// 把改過的資料寫回 canvas
ctx.putImageData(imageData, 0, 0);
}
</script>
為什麼 i 每次加 4?因為 imageData.data 是一個一維的 Uint8ClampedArray,每個像素佔四個位置,依序是 R、G、B、A。所以 i 是紅、i+1 是綠、i+2 是藍、i+3 是透明度。範例沒有改 alpha,所以透明區域的顏色也會被替換——只是因為看不出來而已。
為什麼 canvas 的 width / height 要在 getImageData 前設定?設定 canvas 尺寸會清空內容,所以順序必須是「設尺寸 → 畫圖 → 讀像素」。
直接替換 RGB 會讓原本有明暗漸層的素材變成一塊死板的純色。比較好的做法是把原圖當作「遮罩」,只替換色相而保留亮度:
function tintImage(c, img, r, g, b) {
var cvs = document.getElementById(c);
var ctx = cvs.getContext("2d");
cvs.width = img.width; cvs.height = img.height;
ctx.drawImage(img, 0, 0);
var data = ctx.getImageData(0, 0, cvs.width, cvs.height);
var d = data.data;
for (var i = 0; i < d.length; i += 4) {
if (d[i + 3] === 0) { continue; } // 完全透明就跳過
// 以原圖的明暗當作係數,疊上新顏色
var lum = (d[i] + d[i + 1] + d[i + 2]) / (3 * 255);
d[i] = r * lum;
d[i + 1] = g * lum;
d[i + 2] = b * lum;
}
ctx.putImageData(data, 0, 0);
}
跨來源圖片會被阻擋。若圖片來自其他網域而未帶 CORS 標頭,canvas 會被標記為「已污染」(tainted),呼叫 getImageData 時瀏覽器會丟出 SecurityError。解法是由圖片伺服器加上 Access-Control-Allow-Origin,並在建立 Image 前設定 img.crossOrigin = "anonymous"。
大圖會卡。1220×880 的圖約有 107 萬個像素,也就是四百多萬次陣列操作。桌機上還算即時,手機上就會有感。若只是要換色,用 CSS 的 filter: hue-rotate() 或混合模式會快得多;真要逐像素處理,記得把結果快取起來,別在每一帧重算。
另外,file:// 協定開啟的頁面同樣會觸發跨來源限制,測試時請務必透過本機或遠端 HTTP 伺服器開啟。