日月潭即時 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/。原本渲染圖檢視器與模型下載保留,首頁提供漫遊入口。
可操作內容
- 真正以 Three.js 即時繪製的 Blender 衍生模型;可改變位置與視角。
- WASD/方向鍵按住連續走動,Shift 快走;右下箭頭可用滑鼠按住。拖曳環視,也可鎖定滑鼠,Esc 解除。按鈕焦點不再攔截走路鍵;文字框/選單/滑桿保留鍵盤操作。
- 手機左側搖桿移動,右側畫面環視;直式與橫式配置。
- 中庭、接待、展廳、影音室、水庭與湖岸平台,共七個安全跳轉點。
- 牆面碰撞、地面與低階跨越;限向山樣區,湖面與未建區域有邊界。
- 進入時從湖岸開始,也可選「先看日月潭全湖」。園區俯瞰與全湖俯瞰分開;全湖模式可回向山步行,沒有把全湖地形冒充全區可步行。
- 日光/暮色、小波紋水面、連續岸邊材質、地形平滑法線、小地圖、全螢幕、畫質選單。左上步行公尺數提供移動回饋;撞牆或碰到邊界會提示。
- 全湖圖使用原 WRA 水域範圍(1,564 個邊界點)與觀光 POI;水社、伊達邵、文武廟等只作定位,沒有建築精模。水域範圍不是即時水位下的精確岸線。
- 自動畫質依初始觸控裝置和實際幀率降低解析度、陰影、遠林數量。這不是 GPU 型號分級,也不保證所有手機同等畫質。
- 湖邊邊界不再反覆抬升/落下;階差視角平滑、陰影以光源像素格固定。地形本身沒有震動動畫。
- 高/均衡畫質使用 512px 場景鏡射水面,均衡最多每秒更新 20 次;效能模式保留較省資源的波紋水面。波紋法線自行計算,Three.js Water 為 MIT。遠林使用 12,469 株母檔既有散布位置的樹冠卡片,避免對已烘焙光照再打一次光。
- 湖岸木平台屬作者樣區,並非現地向山眺望平台。地形與湖形有資料依據,不代表所有可見物件是現場精確重建。
資產與重現
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、室內亮度、觸控雙指同時操作、夜景切換及載入速度。
向山仍為推估重建樣區,尚非完整日月潭或照片級復刻。影音室目前是靜態展項,沒有新增影片、人群、聊天或其他日月潭地標。