NetBeans 構建與運行 Project Looking Glass 3D 桌面環境完整指南

Project Looking Glass (LG3D) 是 Sun 開源的基於 Java 3D 的 3D 桌面窗口管理器。本文詳細記錄在 Linux 平台上，使用 NetBeans IDE 從源碼構建、配置運行環境的完整流程 (基於 LG3D dev-0-6-2 分支)。

1. 硬件與系統需求

已驗證顯卡：NVIDIA GeForce 2+ (驅動 5336/6629)、ATI Radeon 7500 (DRI)。

2. 環境安裝腳本 (Root 權限)

# 1. JDK 1.5.0
cd /tmp
/bin/bash jdk-1_5_0_02-linux-i586-rpm.bin
rm jdk-1_5_0_02-linux-i586.rpm jdk-1_5_0_02-linux-i586-rpm.bin

# 2. Java 3D 1.3.2
cd /tmp
unzip java3d-1_3_2-linux-i586.zip
cd /usr/java/jdk1.5.0/jre
unzip /tmp/java3d-1_3_2-linux-i586/j3d-132-linux-x86.zip
rm -r /tmp/java3d-1_3_2-linux-i586

# 3. Java Advanced Imaging (JAI) 1.1.2
cd /usr/java/jdk1.5.0
/bin/bash /tmp/jai-1_1_2-lib-linux-i586-jdk.bin

# 4. 環境變量 (~/.bashrc)
export JAVA_HOME=/usr/java/jdk1.5.0
export PATH=$JAVA_HOME/bin:$PATH

# 5. NetBeans 4.1
cd /tmp
chmod +x netbeans-4_1-linux.bin
./netbeans-4_1-linux.bin

3. 關鍵：配置 24 位色深 (X11)

LG3D 強制要求 24 位色深，默認常為 16 位。驗證：xdpyinfo | grep "depth of root"。

• SuSE / Java Desktop System：sax2 → Color and Resolution → 16.7 Mio.[24 Bit] → 測試保存。
• RedHat Fedora 2：編輯 /etc/X11/xorg.conf，Section "Screen" → DefaultDepth 24, DefaultFbBpp 32。
• RedHat 8/9 等：編輯 /etc/X11/XF86Config，Section "Screen" → DefaultDepth 24，SubSection "Display" → Depth 24。

修改後註銷重登，再次驗證 xdpyinfo 輸出 24 planes。

4. NetBeans 從 CVS 獲取源碼

需在 java.net 註冊賬號。兩個模塊：lg3d-core、lg3d-demo-apps。

1. 菜單 Versioning → CVS → Check Out。
2. 服務器：cvs.dev.java.net，端口 2401，類型 pserver。
3. 用戶名/密碼：java.net 賬號。
4. 倉庫路徑：/cvs。
5. 模塊：lg3d-core，標籤：dev-0-6-2。
6. 工作目錄：統一路徑 (如 /home/user/my-lg3d)，兩模塊放同級目錄。
7. 重複上述步驟 Check Out lg3d-demo-apps (同工作目錄，模塊名不同)。

5. 在 NetBeans 中打開並構建項目

1. File → Open Project 選擇 lg3d-core 目錄 (含 nbproject)。
2. 項目窗口右鍵 lg3d-core → Build Project (Ant 構建)。
3. 輸出窗口顯示 BUILD SUCCESSFUL。

6. 運行 Looking Glass 窗口管理器

1. 項目右鍵 → Run Project。
2. 啟動 3D 桌面環境，任務欄含 CD 查看器 (3D 演示)、xterm (X11 整合)、退出圖標。
3. 滑鼠懸停光盤堆疊可預覽，點擊運行演示應用。

7. 配置 lg3d-demo-apps 獨立項目 (可選)

修改演示應用需單獨項目：

1. File → New Project → General → Java Project with Existing Sources。
2. 項目名 lg3d-demo-apps，源目錄指向 lg3d-demo-apps/src/classes。
3. 項目屬性 → Libraries → Compile → Add Jar/Folder → 添加 lg3d-core/build/classes。
4. 即可編輯演示代碼 (如 WebIcon.java)，F9 編譯，Run lg3d-core 即時生效。

常見問題

• 色深不足：最常見失敗原因，嚴格檢查 24 位。
• 顯卡驅動：NVIDIA 6629 驅動需額外配置；ATI 需 DRI。
• CVS 認證：確保 java.net 賬號激活，密碼正確。
• 內存不足：構建/運行需 ≥512MB，建議 1GB+。

本指南基於 2005 年 LG3D 開發版，現代系統可嘗試在虛擬機中復現歷史項目，或參考其 3D UI 架構設計思想。