萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

HTML5 Canvas 圖片像素級顏色替換:ImageData API 實現即時濾鏡效果

HTML5 <canvas> 配合 CanvasRenderingContext2D.getImageData() / putImageData(),提供像素級圖像處理能力。本文實作一個通用函式:載入圖片 → 繪製至 Canvas → 遍歷像素陣列 → 將指定 RGB 顏色替換為新顏色 → 回寫 Canvas,適用於遊戲素材重著色、UI 主題切換、圖片特效處理。

核心 API 流程

  1. new Image() 載入圖片
  2. img.onload 確保圖片解碼完成
  3. canvas.width/height = img.width/height 設定畫布尺寸
  4. ctx.drawImage(img, 0, 0) 繪製原圖
  5. ctx.getImageData(0, 0, w, h) 取得 ImageData 物件 (含 data: Uint8ClampedArray)
  6. 遍歷 data (每 4 個元素 = R, G, B, A)
  7. 比對目標顏色,符合則替換
  8. 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 資料結構

  • ImageData.data:Uint8ClampedArray (0-255 自動鉗制)
  • 長度 = width × height × 4 (RGBA)
  • 索引對應:i=R, i+1=G, i+2=B, i+3=A
  • 行跨距:(y * width + x) * 4

容差比對策略

本例採用歐氏距離平方比較,平衡效能與視覺效果。

效能優化技巧

  • 快取原始 ImageData:避免重複 drawImage + getImageData
  • Uint8ClampedArray 複製:new Uint8ClampedArray(original.data) 比 slice() 更快
  • 避免函數調用:循環內內聯邏輯、預計算常數
  • Web Worker 離屏處理:大圖 (>2MP) 移至 Worker,主執行緒不阻塞
  • OffscreenCanvas:在 Worker 直接繪製/處理,零拷貝傳回
  • SIMD / WASM:極致效能需求可移植至 WebAssembly

跨域圖片污染 (Tainted Canvas) 解決

img.crossOrigin = 'anonymous'; // 圖片端需回應 Access-Control-Allow-Origin: *
  • 同域圖片:無限制
  • 跨域圖片:需 CORS 標頭,否則 getImageData() 拋出 SecurityError
  • Data URL / Blob URL:視為同域

擴展應用場景

  • 遊戲素材動態換色:角色裝備、單位陣營顏色
  • UI 主題切換:單一圖標素材,跑調色板生成深/淺色模式
  • 照片濾鏡預覽:色相旋轉、飽和度、亮度調整 (HSL 空間運算)
  • 綠幕抠圖:替換特定綠色範圍為透明
  • 數據視覺化:熱力圖像素級著色

現代替代方案:CSS Filter / SVG Filter

若僅需整體色調調整 (色相旋轉、飽和度、亮度、對比),CSS Filter 效能極佳、無需 Canvas:

.recolor { filter: hue-rotate(120deg) saturate(1.5) brightness(1.1); }

SVG <feColorMatrix> 提供矩陣級色彩變換,可在 CSS filter: url(#svgFilter) 引用。

總結

Canvas ImageData API 開啟了瀏覽器端像素運算大門。本文實作的「指定顏色替換」展示核心流程:載入 → 繪製 → 讀取像素 → 運算 → 回寫。掌握 Uint8ClampedArray 操作、容差比對、跨域處理、效能優化 (Worker/OffscreenCanvas/WASM),即可構建專業級圖像編輯、遊戲渲染、資料視覺化應用。

copyright © 萬盛學電腦網 all rights reserved
策略公式特性
精確比對r===R && g===G && b===B快、無誤判、不耐壓縮伺服器
歐氏距離 (含容差)(r-R)²+(g-G)²+(b-B)² ≤ tol²自然視覺相似度、可調整寬鬆度
曼哈頓距離|r-R|+|g-G|+|b-B| ≤ tol計算快、菱形容差區域
CIEDE2000感知均勻色差公式最符合人眼、計算極重、需庫支援