HTML5 <canvas> 配合 CanvasRenderingContext2D.getImageData() / putImageData(),提供像素級圖像處理能力。本文實作一個通用函式:載入圖片 → 繪製至 Canvas → 遍歷像素陣列 → 將指定 RGB 顏色替換為新顏色 → 回寫 Canvas,適用於遊戲素材重著色、UI 主題切換、圖片特效處理。
new Image() 載入圖片img.onload 確保圖片解碼完成canvas.width/height = img.width/height 設定畫布尺寸ctx.drawImage(img, 0, 0) 繪製原圖ctx.getImageData(0, 0, w, h) 取得 ImageData 物件 (含 data: Uint8ClampedArray)data (每 4 個元素 = R, G, B, A)ctx.putImageData(imageData, 0, 0) 回寫畫布<!DOCTYPE html>
<html lang="zh-TW">
<head>
<meta charset="UTF-8">
<title>Canvas 圖片顏色替換示例</title>
<style>
body { font-family: 'Microsoft JhengHei', sans-serif; padding: 20px; }
.container { display: flex; gap: 20px; flex-wrap: wrap; align-items: flex-start; }
canvas { border: 1px solid #ddd; border-radius: 4px; background: #f9f9f9; }
.controls { display: flex; flex-direction: column; gap: 10px; min-width: 280px; }
label { display: flex; align-items: center; gap: 8px; font-size: 14px; }
input[type="color"] { width: 40px; height: 30px; border: none; cursor: pointer; }
button { padding: 10px 16px; background: #0066cc; color: #fff; border: none; border-radius: 4px; cursor: pointer; }
button:hover { background: #0052a3; }
button:disabled { background: #99c; cursor: not-allowed; }
</style>
</head>
<body>
<h1>Canvas 即時顏色替換</h1>
<p>點選色盤選擇「目標顏色」與「替換顏色」,再按下套用。支援透明度保留。</p>
<div class="container">
<canvas id="canvas" width="600" height="400">您的瀏覽器不支援 Canvas</canvas>
<div class="controls">
<label>目標顏色 (要被替換):
<input type="color" id="oldColor" value="#ff0000">
</label>
<label>替換顏色:
<input type="color" id="newColor" value="#00ff00">
</label>
<label>容差 (0-255):
<input type="range" id="tolerance" min="0" max="255" value="0">
<span id="toleranceVal">0</span>
</label>
<label>
<input type="checkbox" id="preserveAlpha" checked> 保留原圖透明度
</label>
<button id="applyBtn" onclick="applyRecolor()">套用替換</button>
<button id="resetBtn" onclick="resetCanvas()">重置原圖</button>
<button onclick="downloadCanvas()">下載結果</button>
</div>
</div>
<script>
const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');
let originalImageData = null; // 快取原始像素資料
let sourceImage = null;
// 載入示例圖片 (替換為您的圖片路徑)
function loadDemoImage() {
const img = new Image();
img.crossOrigin = 'anonymous'; // 支援跨域圖片 (需伺服器 CORS)
img.src = 'https://via.placeholder.com/600x400/ff0000/ffffff?text=Red+Target+Color';
img.onload = () => {
sourceImage = img;
resetCanvas();
};
img.onerror = () => {
console.warn('示例圖片載入失敗,建立純色測試圖');
createTestPattern();
};
}
function createTestPattern() {
// 建立一個包含紅色區域的測試圖
const w = 600, h = 400;
canvas.width = w; canvas.height = h;
ctx.fillStyle = '#fff'; ctx.fillRect(0, 0, w, h);
ctx.fillStyle = '#ff0000'; ctx.fillRect(50, 50, 200, 150); // 紅色矩形
ctx.fillStyle = '#00ff00'; ctx.fillRect(300, 100, 150, 200); // 綠色
ctx.fillStyle = '#0000ff'; ctx.fillRect(100, 300, 300, 50); // 藍色
ctx.font = 'bold 30px sans-serif'; ctx.fillStyle = '#ff0000'; ctx.fillText('RED TEXT', 200, 200);
cacheOriginal();
}
function cacheOriginal() {
originalImageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
}
function resetCanvas() {
if (sourceImage) {
canvas.width = sourceImage.width;
canvas.height = sourceImage.height;
ctx.drawImage(sourceImage, 0, 0);
}
cacheOriginal();
updateToleranceLabel();
}
function hexToRgb(hex) {
const m = hex.match(/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i);
return m ? [parseInt(m[1],16), parseInt(m[2],16), parseInt(m[3],16)] : [0,0,0];
}
function applyRecolor() {
if (!originalImageData) return;
const oldRgb = hexToRgb(document.getElementById('oldColor').value);
const newRgb = hexToRgb(document.getElementById('newColor').value);
const tolerance = parseInt(document.getElementById('tolerance').value, 10);
const preserveAlpha = document.getElementById('preserveAlpha').checked;
// 複製像素資料 (避免污染快取)
const data = new Uint8ClampedArray(originalImageData.data);
const len = data.length;
for (let i = 0; i < len; i += 4) {
const r = data[i], g = data[i+1], b = data[i+2], a = data[i+3];
// 透明像素跳過
if (a === 0) continue;
// 計算色差 (歐氏距離平方,避免開根號)
const dr = r - oldRgb[0];
const dg = g - oldRgb[1];
const db = b - oldRgb[2];
const distSq = dr*dr + dg*dg + db*db;
if (distSq <= tolerance * tolerance) {
data[i] = newRgb[0];
data[i+1] = newRgb[1];
data[i+2] = newRgb[2];
// Alpha 保持不變 (preserveAlpha 預設 true)
}
}
// 建立新 ImageData 並回寫
const newImageData = new ImageData(data, canvas.width, canvas.height);
ctx.putImageData(newImageData, 0, 0);
}
function updateToleranceLabel() {
document.getElementById('toleranceVal').textContent = document.getElementById('tolerance').value;
}
document.getElementById('tolerance').addEventListener('input', updateToleranceLabel);
function downloadCanvas() {
const link = document.createElement('a');
link.download = 'recolored-image.png';
link.href = canvas.toDataURL('image/png');
link.click();
}
// 初始化
loadDemoImage();
</script>
</body>
</html>
ImageData.data:Uint8ClampedArray (0-255 自動鉗制)width × height × 4 (RGBA)i=R, i+1=G, i+2=B, i+3=A(y * width + x) * 4| 策略 | 公式 | 特性 |
|---|---|---|
| 精確比對 | r===R && g===G && b===B | 快、無誤判、不耐壓縮伺服器 |
| 歐氏距離 (含容差) | (r-R)²+(g-G)²+(b-B)² ≤ tol² | 自然視覺相似度、可調整寬鬆度 |
| 曼哈頓距離 | |r-R|+|g-G|+|b-B| ≤ tol | 計算快、菱形容差區域 |
| CIEDE2000 | 感知均勻色差公式 | 最符合人眼、計算極重、需庫支援 |