您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> J2ME

J2ME GIF 動畫解碼器：單一文件實現多幀動畫

編輯：J2ME

前言

在 J2ME 開發早期，受限於 JAR 包大小與手機儲存空間，開發者常面臨動畫資源佔用過大的難題。傳統做法需將每一幀另存為 PNG 序列圖，不僅增加美術成本，更嚴重膨脹安裝包體積。本文介紹一個輕量級的 GIFDecode 類別，能直接解析 GIF 文件並逐幀播放，以單一資源檔替代多張圖片，大幅降低資源佔用。

核心功能與設計思路

GIFDecode 完整實現了 GIF89a 規範中的關鍵特性：

全域/區域色表處理：自動識別並套用正確調色盤
圖形控制擴展：解析延遲時間、透明色索引、棄置方式
LZW 解碼器：內建高效像素資料還原演算法
交織掃描支援：正確重建隔行掃描影像
Netscape 循環擴展：讀取並遵循動畫重播次數

類別採用「幀物件池」設計：解碼完成後將每幀轉為 Image 物件並暫存於 Vector，執行期僅需按索引取用，避免重複解碼開銷。

快速上手範例

private GIFDecode gifDecoder;
private int currentFrame = 0;
private int totalFrames;
private Image frameImage;

void initGIF() {
    gifDecoder = new GIFDecode();
    // 從 JAR 內部資源載入
    gifDecoder.read(getClass().getResourceAsStream("/animation.gif"));
    totalFrames = gifDecoder.getFrameCount();
}

void drawAnimation(Graphics g, int x, int y, int anchor) {
    frameImage = gifDecoder.getFrame(currentFrame);
    currentFrame = (currentFrame + 1) % totalFrames; // 循環播放
    g.drawImage(frameImage, x, y, anchor);
}

關鍵原始碼解析

1. GIF 文件頭與邏輯螢幕描述符讀取

protected void readHeader() {
    String id = "";
    for (int i = 0; i < 6; i++) id += (char) read();
    if (!id.startsWith("GIF")) { status = STATUS_FORMAT_ERROR; return; }
    readLSD(); // 讀取螢幕尺寸、全域色表標誌等
    if (gctFlag && !err()) {
        gct = readColorTable(gctSize);
        bgColor = gct[bgIndex];
    }
}

2. 圖形控制擴展解析（關鍵動畫參數）

protected void readGraphicControlExt() {
    read(); // 區塊大小
    int packed = read();
    dispose = (packed & 0x1c) >> 2;      // 棄置方式
    if (dispose == 0) dispose = 1;        // 預設保留上一幀
    transparency = (packed & 1) != 0;     // 透明旗標
    delay = readShort() * 10;             // 延遲(毫秒)
    transIndex = read();                  // 透明色索引
    read(); // 區塊結束符
}

3. LZW 像素資料解碼核心

演算法採用動態字典表，MaxStackSize = 4096 符合 GIF 規範上限。解碼過程中以位元流方式讀取編碼，遇到 CLEAR 碼重置字典，END_OF_INFORMATION 結束解碼。像素索引寫入 pixels[] 陣列，後續由 setPixels() 映射為 ARGB 色值。

4. 幀合成與棄置邏輯

protected void setPixels() {
    int[] dest = new int[width * height];
    // 根據上一幀棄置方式處理背景
    if (lastDispose > 0) { ... }
    // 處理交織掃描行序
    int pass = 1, inc = 8, iline = 0;
    for (int i = 0; i < ih; i++) {
        int line = interlace ? computeInterlaceLine(iline++, pass, inc, ih) : i;
        line += iy;
        if (line < height) copyPixelLine(dest, line, i);
    }
    image = Image.createRGBImage(dest, width, height, false);
}

效能與記憶體考量

記憶體佔用：width × height × 4 bytes × 幀數。建議單一 GIF 幀數 ≤ 20、解析度 ≤ 176×208。
解碼耗時：首次 read() 會完整解碼全檔，建議在載入畫面或背景執行緒執行。
透明色處理：將透明索引對應色值設為 0（全透明 ARGB），繪製時略過寫入。

常見坑點與解決方案

問題	原因	對策
動畫播放速度過快/過慢	未正確讀取 `delay` 欄位	確認 `readGraphicControlExt()` 中 `delay = readShort() * 10`（單位：百分之一秒→毫秒）
透明背景變黑底	未將透明索引色值設為 0	在 `readImage()` 中 `act[transIndex] = 0` 後再 `setPixels()`
部分手機顯示花屏	色表索引超出邊界或 LZW 解碼錯誤	加強 `err()` 檢查，確保 `pixels[]` 長度 = `iw × ih`