J2ME 3D (JSR 184 / M3G) 完整入門：從核心概念到旋轉金字塔實戰

JSR 184 (Mobile 3D Graphics API, M3G) 為 Java ME 引入輕量級 3D 能力，基於 OpenGL ES 子集，運行於 CLDC 1.1+/MIDP 1.0+，完整實現 < 150KB。本文系統介紹 M3G 架構、兩種渲染模式、資源載入、核心類別，並附帶可在 WTK 2.2 模擬器運行的旋轉金字塔完整代碼。

M3G 核心架構

兩種渲染模式

• 立即模式：每幀手動調用 Graphics3D.render(mesh...)，控制精細、效能高、代碼繁瑣。
• 保留模式：構建 World 場景圖，調用 g3d.render(world) 自動遍歷繪製，適合複雜場景、動畫插值。
• 可混合使用：背景/靜態物件保留模式，粒子/特效立即模式。

.m3g 檔案製作流程

1. 3ds Max / Blender 建模、骨骼動畫、材質烘焙。
2. 導出為 M3G 格式 (需 M3G Exporter 外掛)。
3. 放入 JAR /res/ 目錄，Loader.load("/res/scene.m3g") 載入。

完整範例：旋轉金字塔

import javax.microedition.m3g.*;
import javax.microedition.lcdui.*;

public class PyramidMIDlet extends MIDlet implements Runnable {
    private Graphics3D g3d;
    private World world;
    private Mesh pyramid;
    private Display display;

    public void startApp() {
        display = Display.getDisplay(this);
        Canvas3D canvas = new Canvas3D();
        display.setCurrent(canvas);
        new Thread(this).start();
    }

    class Canvas3D extends Canvas {
        public void paint(Graphics g) {
            try {
                g3d.bindTarget(g);
                g3d.render(world);
            } finally {
                g3d.releaseTarget();
            }
        }
    }

    public void run() {
        // 1. 取得 Graphics3D 實例
        g3d = Graphics3D.getInstance();

        // 2. 建立 World 與 Camera
        world = new World();
        Camera cam = new Camera();
        world.addChild(cam);
        float w = getWidth(), h = getHeight();
        cam.setPerspective(60f, w/h, 0.1f, 50f);
        world.setActiveCamera(cam);

        // 3. 程序化建立金字塔 Mesh
        pyramid = createPyramid();
        pyramid.translate(0, 0, -3f);  // 移入視野
        world.addChild(pyramid);

        // 4. 幀循環
        Graphics g = getGraphics();
        while (true) {
            pyramid.postRotate(3f, 0f, 1f, 0f); // 繞 Y 軸旋轉 3°
            g3d.bindTarget(g);
            g3d.render(world);
            g3d.releaseTarget();
            flushGraphics();
            try { Thread.sleep(16); } catch (Exception ignore) {}
        }
    }

    private Mesh createPyramid() {
        // 頂點：底面 4 點 + 頂點
        short[] verts = { -1,-1,-1,  1,-1,-1,  1,1,-1,  -1,1,-1,  0,0,1 };
        byte[] indices = { 0,1,2,  0,2,3,  0,4,1,  1,4,2,  2,4,3,  3,4,0 };
        VertexArray va = new VertexArray(5, 3, 2); // 5 頂點, 3 分量, 2 bytes
        va.set(0, 5, verts);
        TriangleStripArray tsa = new TriangleStripArray(4, indices); // 4 條帶
        return new Mesh(va, tsa, new Appearance());
    }

    // 其他生命週期方法省略
}

支援設備與現代替代

• 經典支援機型：Nokia 6230/6600/7650、Siemens S65、Sony Ericsson K700i/P900、Moto T720。
• 底層多採用 SuperScape Swerve 引擎 (C 實現)。
• 現代替代：Android OpenGL ES 2.0+/3.0+、LibGDX、jMonkeyEngine、Unity (C#)、Godot。