Nokia UI API 快速參考：FullCanvas、DirectGraphics、DirectUtils 核心功能與實戰範例

核心類別速覽

DirectGraphics 進階繪圖實戰

取得 DirectGraphics 實例

DirectGraphics dg = DirectUtils.getDirectGraphics(g); // g 為標準 Graphics

多邊形繪製

int[] polygonX = { 30, 50, 30, 10 };
int[] polygonY = { 10, 30, 50, 30 };
dg.drawPolygon(polygonX, 0, polygonY, 0, polygonX.length, 0);

圖片水平翻轉（鏡像）

dg.drawImage(img, x, y, anchor, DirectGraphics.FLIP_HORIZONTAL);

圖片順時針 90° 旋轉

dg.drawImage(img, x, y, anchor, DirectGraphics.ROTATE_90);

支援 ROTATE_180、ROTATE_270、FLIP_VERTICAL、FLIP_HORIZONTAL 組合。

DirectUtils 可變動圖片與像素操作

建立可變動圖片（支援 Alpha 通道）

Image mutableImg = DirectUtils.createImage(width, height, 0x00000000); // 最後參數 ARGB，0x00=全透明
Graphics g = mutableImg.getGraphics();
// 繪製內容...

圖塊切割：從圖集提取精靈

// fivemen.png: 60x12，包含 5 個 12x12 角色
Image fivemen = Image.createImage("/fivemen.png");
Image[] man = new Image[5];
for (int i = 0; i < 5; i++) {
    man[i] = DirectUtils.createImage(12, 12, 0x00000000);
    Graphics g = man[i].getGraphics();
    // 負座標偏移實現「視窗裁切」
    g.drawImage(fivemen, -12 * i, 0, Graphics.TOP | Graphics.LEFT);
}

像素級存取：建立反色圖片（灰階）

Image createInvertedImage(Image src) {
    int w = src.getWidth(), h = src.getHeight();
    Image dst = DirectUtils.createImage(w, h, 0x00000000);
    
    int numBytes = (w * h + 7) / 8; // 1 bit per pixel
    byte[] pixels = new byte[numBytes];
    byte[] mask = new byte[numBytes];
    
    DirectGraphics dg = DirectUtils.getDirectGraphics(src.getGraphics());
    dg.getPixels(pixels, mask, 0, w, 0, 0, w, h, DirectGraphics.TYPE_BYTE_1_GRAY_VERTICAL);
    
    // 像素反轉邏輯（此處略）...
    // 將 pixels 寫回 dst...
    return dst;
}

適用場景與遷移建議

• 適用：Nokia Series 40/60、S40/S60 專屬遊戲、需高效能 2D 渲染的專案
• 限制：僅限 Nokia 裝置，跨平台需封裝抽象層或優雅降級至標準 LCDUI
• 現代映照：DirectGraphics 的翻轉/旋轉/Alpha 功能，對應現代 Canvas.drawBitmap() + Matrix / Shader；DirectUtils 圖塊切割對應 Bitmap.createBitmap() 圖集切圖

版本相容性提醒

Nokia UI API 隨 S40/S60 版本演進，部分方法在早期固件缺失。發布前必須在目標機型矩陣上實機測試，並準備標準 LCDUI 降級渲染路徑。