日月潭即時 3D 漫遊:環湖與水社近景

2026-09-24 水社更新:新增從 Blender 匯出的 shuishe.glb,與 campus/region 三份幾何合成同一場景。八筆碼頭及四艘客船由獨立母檔製作,原簡化碼頭與兩艘簡船移除。碰撞整合在 region-collision,預設入場面向新客船。69 項輸入/碰撞/水面/碼頭測試全過;Browser 與真手機仍未驗。來源、離線前後圖及下載見 水社近景說明。

最新範圍與建模管線見 環湖版本說明。v4 在原 v3 基礎上新增 region GLB、碰撞、遠林與 OSM 來源資料庫;19 個可抵達地點、分類搜尋、地圖點選與戶外快行。向山可進室內,環湖地標目前為外觀。53 項測試通過,另將 13 項舊移動案例套用新碰撞全過。沒有真手機或 Browser 視覺驗收。

以下保留 v3 的底層材質/輸入實作說明;原「七地點/其他景點未建」為當時範圍,現在以上方 v4 說明為準。

入口:https://sunmoon.sunstyled.com/walk/。原本渲染圖檢視器與模型下載保留,首頁提供漫遊入口。

可操作內容

資產與重現

Blender 母檔:xiangshan-campus-v06.blend;SHA 6a5b2182d155ddb042eb7d1b9e8af1611f2dd7b00cc8528936e620aab4521559,匯出過程不儲存、不覆寫它。

blender/export_walk.py 讀取母檔,以向山為原點轉成 Y-up 公尺座標,輸出標準 GLB、獨立碰撞三角形、植栽實例矩陣。遠方地形簡化、掃描樹分近/遠 LOD,文字曲線與陶器細分降低,近草抽樣。Cycles 程序材質不會原封不動進入網頁,而是由掃描 PBR 圖與即時材質重建。

scripts/prepare_walk.py 將授權貼圖縮到最多 1024px;保留透明葉片 PNG,其餘用 JPEG。Three.js 固定 0.170.0,由工作區已安裝版本複製所需模組與 MIT LICENSE,所有資源同站提供,不依賴外部 CDN。walk-assets.json 保存成品 SHA。

遠林使用 blender/bake_walk_trees.py 從原有兩種 CC0 掃描樹烘焙的四張 768px 透明樹冠,交叉平面共用實例;近樹保留最高約 24,000 三角形的立體 LOD。不是逐株實地測量。首次準備或改樹模型需先跑烘焙腳本,再執行 prepare。

& 'C:/Program Files/Blender Foundation/Blender 5.1/blender.exe' --background blender/xiangshan-campus-v06.blend --python-exit-code 1 --python blender/export_walk.py
.venv/Scripts/python.exe scripts/prepare_walk.py
.venv/Scripts/python.exe scripts/prepare_walk_landscape.py
.venv/Scripts/python.exe scripts/audit_walk.py
node --test walk/tests/input.test.mjs walk/tests/movement.test.mjs walk/tests/lake.test.mjs
.venv/Scripts/python.exe scripts/build_site.py

上線沿用 scripts/deploy_site.sh 與既有 vps3 靜態站。build_site.py 只把指定 runtime、衍生資產、vendor 及授權檔加入白名單;測試、研究快取、原始圖面及開發環境不發布。JS/CSS 帶版本雜湊。

驗證界線

20 項測試通過:輸入/按鈕焦點、室內碰撞、低階跨越、湖岸行走等原 17 項,加上邊界晃動、退回可走範圍與倒影網格保留原湖形/水位。邊界測試沿 v2 實際重現方向在 30/60/120Hz 執行。舊版放開按鍵仍有約 8.67cm 震幅;新版穩定範圍小於 2mm。這些是程式測試,不等於瀏覽器事件/GPU 渲染整合測試。

prepare_walk_landscape.py 只平滑衍生 GLB 的地形法線,不更改地形頂點、湖面高程或碰撞檔;重做素材後需執行。Blender 離線檢查確認全湖取景與湖岸位置,並非瀏覽器截圖;它不能驗證 WebGL 水面 shader。地形仍是 20m DTM 來源,岸緣折線、近/遠地形 LOD 接縫、非本地樹種與近景細節仍未達寫實驗收。

當前 Browser 連線清單為空,無法完成瀏覽器實際畫面/點擊驗收;也沒有實機手機 FPS 結果。來源模型與 GLB 結構驗證不能替代這些測試。請 Claude 優先實開桌面與手機,核對 shader、室內亮度、觸控雙指同時操作、夜景切換及載入速度。

向山仍為推估重建樣區,尚非完整日月潭或照片級復刻。影音室目前是靜態展項,沒有新增影片、人群、聊天或其他日月潭地標。