日月潭環湖自行車道(主線,閉合一圈)
狀態:2026-09-25 完成主線、地形接合、Blender 母檔 blender/lake-bikeway-v01.blend、網頁分塊與碰撞、walk/bikeway.js。
2026-09-25 已接進 walk/main.js 並上線;2026-09-26 加上路邊植被與近地面質感(§11)。
座標一律是 walk 執行期座標:x 往東、y 向上、z 往南(公尺);原點 向山 E240030.107 N2638540.908(TWD97),y=0 為 TWVD2001 763.55 m,湖面 y = -15.55。
1. 路線
- 方向:順時針(管理處建議自向山遊客中心出發順時針):向山 → 同心橋、永結橋 → 水社壩木棧道 → 向山段水上自行車道 → 北旦 → 水社 → 朝霧碼頭 → 九龍口 → 文武廟 → 松柏崙 → 大竹湖 → 水蛙頭 → 纜車站 → 伊達邵水上自行車道 → 伊達邵碼頭 → 玄光寺 → 環湖一號、二號隧道 → 頭社 → 綠水橋 → 水社隧道 → 向山。
- 長度:中心線 28,988 m(OSM 原線形 29.3 km,平滑後);管理處「環潭約 30 公里」。
- 為什麼經頭社:管理處環潭路線頁「經玄光寺停車場大彎坡後,一路下坡至頭社……最後自頭社返回向山遊客中心」;月潭段(月牙灣至環湖一號隧道口)公告禁止騎乘、需牽行,所以主線走台21甲/台21 經頭社。頭社盆地路面最低 y = -121.6(海拔約 642 m,比湖面低約 106 m),共 4.8 km 低於湖面——這是真實地形(DTM),不是湖底。
- 段別(公尺,每 1 m 站統計):公路(與汽車共用)22,845、自行車道 3,063、橋 1,810、木棧道 716、隧道 348、水社保留區(精修步道,沿用既有面)206。
- 鋪面:瀝青 24,031、混凝土連鎖磚 2,583、混凝土 1,570、木棧 804。
- 地名與里程(
bike-loop.json 的 places):同心橋 164、永結橋 293、水社壩木棧道起點 1,439、向山段水上自行車道 2,133、北旦 2,575、名勝街 3,187、水社碼頭 3,339、朝霧碼頭 3,941、九龍口 4,701、文武廟 6,370、松柏崙 6,690、大竹湖 8,507、水蛙頭 9,784、纜車站 11,177、伊達邵水上自行車道 11,937、伊達邵碼頭 12,230、玄光寺 18,708、環湖一號隧道 22,658、頭社 25,888、綠水橋 27,690、水社隧道 28,480。
來源
| 項目 |
來源 |
| 環潭約 30 km、順時針、經頭社、「自行車道尚未串接完成,建議沿環潭公路騎乘」 |
日月潭國家風景區管理處「日月潭自行車道-環潭路線」(page_updated 2025-12-03,2026-09-25 取回,.cache/bikeway-review/sources/smla-134.md) |
| 向山段 3.4 km、水上自行車道 0.4 km、永結橋與同心橋「以白色橋墩和木製步道組成」 |
管理處「日月潭自行車道-向山段」(smla-18.md) |
| 各段長度、水社壩木棧道「禁止騎乘,請牽行」、月潭段牽行、險升降坡 |
日月潭自行車旅遊網 ComeBikeDay(觀光署日月潭管理處)comebike-323~328.md |
| 路線線形、橋隧與鋪面標籤、名稱 |
OpenStreetMap(ODbL),walk/assets/region-osm.json,快照 2026-09-22T08:45Z |
| 縱斷面參考高程 |
內政部 20 m DTM(2020-07 LiDAR),data/processed/sun-moon-lake-dtm20.npz |
抓網頁一律 curl -s https://r.jina.ai/<url>,User-Agent 不含任何個資。照片只當參考。 |
|
推估(全部也列在 bike-loop.json 的 estimates)
- 中心線依 OSM 平滑(最大偏移:公路 1.8 m、自行車道 1.0 m、橋 0.5 m);髮夾彎迴轉半徑放寬到公路 9 m、自行車道 4 m。
- 寬度:台21/台21甲 8.3 m(3.25×2+路肩),專用自行車道 3.0 m,聚落巷道 5.0 m,服務道路 4.0 m——OSM 沒寬度,皆推估。
- 水社壩木棧道 OSM 未繪:沿台21壩頂向湖側平移 8 m 推估(先前版本這段走了東→西→東三趟,已修正為單向)。
- OSM 建物(國土測繪中心 LiDAR 建物框、OSM 棚架)伸進路面的 3 處,中心線側移最多 1.45 m(s≈3.7 k、12.3 k、16.2 k),路面已不再壓到任何建物;邊溝仍擦到 3 棟建物邊角(0.00–0.10 m²)。
- 伊達邵碼頭既有木棧平台上方,木棧面貼齊平台面上 7 cm。
- 水社保留區東端 18 m(s≈3,389–3,406)原是舊 OSM 路面帶:改鋪新路面、高程沿用舊面,並側移最多 1.57 m 讓開德拉歌基地面;新舊鋪面交接處新路面搭接 2 m、高出 1.5 cm。
- 護欄型式、擋土牆、橋墩間距、隧道斷面、路燈與地名牌樣式:常見做法推估,非現地測量。
2. 縱斷面
- 方法:以 DTM(高斯 8 m)為目標、4 m 站距做 L1 線性規劃(偏差+曲率,坡度上限 8%),再加三角核豎曲線;保留區固定為既有步行面,保留區兩端以 ±7.76% 錐面銜接。
- 下限:湖面 +0.6 m(湖邊或湖面平面底下的低岸地一律適用;步行者在湖區的邊界是 -15.1),棧道/水上自行車道橋面 ≥ 湖面 +0.95 m,橋面在跨距內 ≥ 地面 +0.5 m,碼頭上方 ≥ 碼頭面 +7 cm。豎曲線平滑後若把某站拉到下限以下,以 ±10 m 漸變補回(最多 0.22 m,67 站)。
- 結果(
bike-loop.json stats.grade,10 m 弦長):最大 8.32%;1 m 最大 8.63%;>8% 共 983 m(全部 8.0–8.3%,是 LP 頂到上限的長坡)、>10% 0 m。保留區內(既有精修步道)最大 16.9%(水社碼頭東側坡道,原作者的面,未改)。
- 分布:0–2% 9,555 m、2–4% 5,843 m、4–6% 5,237 m、6–8% 7,333 m、8–10% 989 m、10%以上 31 m(全在保留區內)。總爬升 572 m;最高 y = 94.6(台21甲玄光寺往頭社段)、最低 y = -121.6(頭社盆地)。
3. 地形接合(scripts/terrain_edits.py,通用工具)
工具做什麼
從原始地形層一次套用所有編輯規格,產生衍生檔(不覆寫原檔):
- 讀:walk/assets/campus-ecology.glb(區域地形 terrain-upland/terrain-shore 主網格、向山園區草坪 ground)、walk/assets/region-town.glb(舊 OSM 路面 asphalt/paving/road-line/rail)、walk/assets/region-town-collision.bin。
- 寫:campus-ecology-<suffix>.glb、region-town-<suffix>.glb、region-town-<suffix>-collision.bin、terrain-<suffix>.json(規格、改動面數、原檔與新檔 SHA-256)。
- 做法:各規格決定範圍與約束 → 在「全部範圍的聯集」重新做受約束 Delaunay 三角化、依約束求高程、平面簡化 → 切開原網格並用原網格邊界高程接回(共點、不留縫)→ 同一批三角面寫進碰撞(視覺與碰撞一起改)。範圍內的舊 OSM 路面剔除,其餘舊路面依新地形重貼。
- 不可改:水社精修地形小塊(< 8000 面的 terrain 小塊)、各 Blender 精修地面(dellago、waterfront、ecology-ground…)、建築。
輸入格式
規格檔是含 "terrain_edits" 陣列的 JSON(或直接一個陣列),可以一次給多檔。y 為 walk 座標。
{"terrain_edits": [
{"kind": "pad", "name": "文武廟前庭", "polygon": [[2540, -2039], [2593, -2039], [2593, -2003], [2540, -2003]],
"height": 55.0, "cut_slope": 1.0, "fill_slope": 1.5, "extent": 30, "owner": "temple"}
]}
pad:多邊形內整平到 height;外圍挖方坡 1:cut_slope(高:水平)、填方坡 1:fill_slope,坡面在 extent 公尺內接回原地形(最後 8 m 漸變)。多邊形邊是折線約束(邊緣銳利)。
corridor:{"kind": "corridor", "name": "bike-loop", "data": "data/processed/terrain-edits/bike-loop-corridor.npz"},路廊資料由 scripts/bike_corridor.py 產生(路面下 12 cm、路肩、挖 1:1/填 1:1.5、擋土牆、橋下淨空、隧道覆土、隧道口開縫)。本路廊規格存在 data/processed/terrain-edits/bike-loop.terrain.json,也複製在 walk/assets/bike-loop.json 的 terrain_edits。
- 重疊時優先序:坡面(rank 1)先套 → 整平面內部(rank 2)→ 路面/橋下/隧道(rank 3)最後;同級時離自身越近者勝。下限高於上限的矛盾點數寫進報告
conflicts(本次 0)。
執行方式(總腦一次跑全部)
.venv/Scripts/python.exe scripts/terrain_edits.py --suffix edited data/processed/terrain-edits/bike-loop.terrain.json <寺廟 pad 規格.json> [...]
約 1–1.5 分鐘。之後重跑驗收:node scripts/audit_bike_loop.mjs --sim --walk --out <報告>、.venv/Scripts/python.exe scripts/audit_bikeway_visual.py、node --test walk/tests/bikeway.test.mjs。
實測:路廊+一塊 36×20 m 測試 pad(文武廟南側、55.05 m、延伸 25 m)一起跑,pad 內高程全為 55.05、外圍填方 1:1.5、挖方 1:1 都對,矛盾 0(測試輸出已刪)。
路廊本身要重算(路線或縱斷面改了)時:scripts/build_bike_loop.py → scripts/build_bikeway_terrain.py(產生路廊資料、規格並呼叫 terrain_edits)→ scripts/export_bikeway_collision.py → Blender 母檔(新版號)→ scripts/finalize_bike_loop.py。
本次改動(walk/assets/terrain-edited.json)
| 檔案 |
原檔 SHA-256(位元組) |
衍生檔 SHA-256(位元組) |
| campus-ecology.glb → campus-ecology-edited.glb |
47f44e4a…2e53e(33,048,392) |
0bb9b523…99a9(36,906,656) |
| region-town.glb → region-town-edited.glb |
20448aed…20f8(53,898,364) |
48200160…0fa0(53,199,680) |
| region-town-collision.bin → region-town-edited-collision.bin |
31697d7f…7e16(8,863,380;246,205 面) |
c1b79517…4f0f(14,823,612;411,767 面) |
| - 改動範圍 1.65 km²;新地形 185,228 面/96,454 點(平面簡化後);原地形/草坪移除 13,900 面、切邊補片 8,809 面。 |
|
|
| - 舊 OSM 路面:視覺剔除 176,913 面、重貼 65,130 面;碰撞剔除 14,559 面、重貼 4,781 面。三角面比對改成「質心+逐點 4 mm」(碰撞檔是 1 mm 捨入,舊的 2 cm 分箱會漏掉約 1/6,曾造成舊路面浮在新路面上)。 |
|
|
| - 水社碼頭:區域層有 16 片只有碰撞、沒有視覺的碼頭邊護牆橫跨水社步道(精修步道後來蓋過去),騎到會撞停,已從衍生碰撞刪除。 |
|
|
| - 擋土牆(長度 m,最高):挖方左 2,800(8.0 m)、挖方右 479(5.5 m)、填方左 1,000(7.0 m)、填方右 5,709(5.75 m)。護欄:左 9,412 m、右 23,779 m。 |
|
|
4. 障礙清理
- 建物:路面(±半寬)已不壓任何 OSM 建物(中心線側移,見推估)。仍在
building_conflicts 的是路面+路肩外 0.6 m 核心帶擦到的建物邊角,只 3 棟碰到邊溝(0.00–0.10 m²)。
- 樹:
BikeLoop.treeBlocked 剔除路面、路肩與改過地形帶內的樹:區域地被樹 336 棵(37,788 棵中)、園區遠樹 524、近樹 6(bike-loop.json integration.trees_culled)。
- 舊路面、碼頭護牆:見 §3。
5. Blender 母檔與網頁資產
- 母檔:
blender/lake-bikeway-v01.blend(51.7 MB,貼圖已 pack);目前定案 v06(2026-09-26~27 對照實景改版+轉角修圓,見 §12)。產生:python scripts/blender_lock.py bikeway -- -b --factory-startup --python-exit-code 1 --python blender/build_bikeway.py -- --version v02(既有版號不覆寫;--version draft 寫到 .cache)。
- 幾何全部程序生成(
scripts/bikeway_geometry.py,numpy only):瀝青/連鎖磚路面與標線(台21 雙黃線、路肩白線;自行車道邊線、虛線、自行車圖示)、L 型邊溝/混凝土邊帶、W 型鋼板護欄、自行車道鋼柱木扶手、木棧道木欄、擋土牆(挖方石砌、填方混凝土)、橋(板、欄、墩;永結橋、同心橋白色橋墩+木棧面)、木棧道椿、隧道(襯砌、檢修步道、燈)、洞口端牆與名牌、路燈(OSM lit=yes,每 30 m)、地名牌(只用實際地名)。
- 分塊:每 500 m 一塊共 58 塊 × LOD0/LOD1,
walk/assets/bikeway/chunk-XX-lod{0,1}.glb(Draco):LOD0 合計 1,343,880 面、8.09 MB(單塊最多 77,400 面、420 KB);LOD1 合計 196,508 面、1.70 MB。
- 碰撞:
walk/assets/bikeway-collision.bin 202,166 面、7.28 MB(路面、邊溝、橋面、護欄雙面、擋土牆、隧道、洞口牆、橋墩;與母檔 80_COLLISION 同一份幾何)。
- 貼圖:Poly Haven CC0,asphalt_02、interlocking_concrete_pavers、concrete_floor_02、rock_wall_04、old_wood_floor(各 diff/nor_gl/rough 1K,共 15 檔 10.3 MB),來源與 SHA 見
walk/assets/bikeway/SOURCES.json。
- 字型:Noto Serif TC Bold(OFL),轉成網格。
- 手機:LOD0 只在 120 m(low)/220 m(balanced)/320 m(high)內載入,LOD1 到 900/1,600/2,600 m;一般視野約 2 塊 LOD0(≈15 萬面)+ 數塊 LOD1。
6. 驗收結果(2026-09-25 最後一輪,全部前景跑完)
- 剖面(
node scripts/audit_bike_loop.mjs,新碰撞聯集 12 檔,每 2 m 左中右 3 點,共 43,173 點):破洞 0、>12 cm 階差 0(最大 9.9 cm)、偏離設計面 >10 cm 0。
- 整圈騎乘(全油門、依彎道半徑煞車,
bindBikeWater 已接):順時針 28,988 m、4,423 s、平均 23.6 km/h、最高 49.2 km/h、事故 0;逆時針 28,988 m、4,388 s、平均 23.8 km/h、最高 54.0 km/h、事故 0(事故=卡住 >1 s、踩不動 >4 s、偏離 >3 m、落水、掉落 >1 m、NaN)。
- 步行 5 段 × 200 m(含頭社盆地 s=24,930):全數走完,最大偏離 1.12 m,無卡住、無掉落(
bindWalkerLake 已接)。
- 視覺穿模與落差(
scripts/audit_bikeway_visual.py,每 2 m、每側 3 點,86,346 點):地景低於路面不足 3 cm 的 1 點(s=3,390 左緣,1.6 cm,德拉歌基地面,見 §8);舊街區層 0;無護欄且落差 >1 m 的 0。
node --test walk/tests/bikeway.test.mjs:7/7 通過(路線閉合與不重疊、坡度、交付檔 SHA、進度/圈數/地圖 API、湖面範圍、掛鉤預設行為、四段順逆向實騎+全圈剖面);整套 walk/tests/*.test.mjs 265/265 通過(physics.js 掛鉤未改變既有行為)。
- 審圖(Cycles,
blender/render_bikeway.py,.cache/bikeway-review/*.png,14 張逐張看過):向山段、同心橋、水社壩木棧道、向山段水上自行車道、水社灣湖岸段 ×2、水社碼頭前步道、水社步道東端、環湖一號隧道洞口、挖方擋土牆、填方擋土牆、頭社髮夾彎空拍、台21 共用道路、伊達邵水上自行車道。審圖地景用程序草地材質(網頁端地景材質是執行期套的),區域森林未匯入。
7. 整合(walk/bikeway.js 檔頭有完整 API)
- 世界檔:
campus-ecology.glb → campus-ecology-edited.glb、region-town.glb → region-town-edited.glb;COLLISION_ASSETS 的 region-town-collision.bin → region-town-edited-collision.bin,再加 bikeway-collision.bin(完整清單 bike-loop.json integration.collision_assets_after)。
- 單車與步行的湖面(必接):
bindBikeWater(bike, loop)(BikePhysics 把低於湖面的地面都當湖岸擋住)、bindWalkerLake(walker, loop)(Walker 在 y < -15.1 一律擋住)。不接的話頭社盆地 4.8 km 騎不進去也走不進去。湖面範圍 = 園區湖面網格聯集(bike-loop.json lake_cover)。為此在 walk/physics.js 加了 Walker.lakeFloorAt 掛鉤(預設 null=原本 -15.1 行為;備份 walk/physics.js.bak_20260925);walk/bicycle.js 未改(包 step)。
- 樹:
loop.treeBlocked(x, z, r) 加在 cullTreesOnRoads/園區樹實例剔除旁。
- 場景:
new Bikeway(scene, loop, {renderer, install: installScene, quality: tier}),每幀 update(camera.position, tier),暮色 setNight。
- 小地圖
loop.mapRoute();環湖進度 loop.progress(x, z, heading)、loop.tracker();上車點 loop.places、loop.stationAt(s)。
- 注意
seams.js 的 cullRegionalOverlaps 在執行期還會剔除園區範圍內的區域路面,對衍生檔一樣適用(稽核未模擬這一步,新路面碰撞在 bikeway-collision.bin,不受影響)。
8. 已知缺口(誠實列)
- 水社步道東端(s≈3,388–3,400):德拉歌基地面(精修 dellago-ground 與 1,915 面的水社地形小塊,兩者都不可改)是 27 m 的粗三角,斜蓋在舊路面帶上。新路面側移後,剩 s=3,390 左緣 1 點只低 1.6 cm(標準 3 cm);右側欄杆外看得到這塊基地面底下的空隙(它原本就懸在 DTM 上方約 6 m)。根治要改德拉歌基地(別人的精修檔),未動。
- ~~向山段水上自行車道、水社灣一帶看起來在草地上~~:2026-09-26 已改,見 §12。
- 坡度 >8% 共 983 m(8.0–8.3%,LP 頂到上限的長坡)+ 1 m 尺度最大 8.63%(豎曲線後補下限處);管理處沒有逐段坡度資料可對照。
- 髮夾彎依 OSM:九龍口自行車道橋、伊達邵碼頭步道有 100° 以上的急彎(半徑 4–6 m),模擬以慢速通過;是否與現地一致未查證。
- 路面寬度、護欄與擋土牆型式、隧道斷面、路燈與牌誌皆推估;隧道內只有燈具網格,沒有即時照明計算。
- 審圖沒有區域森林與網頁地景材質;真實觀感仍要在瀏覽器(接進 main.js 後)看。向山段審圖左側有一片深色浮片、各圖山坡上有黑邊的舊路面帶:推測是舊 OSM 路面貼在舊 DTM 上(執行期 seams.js 會剔除園區範圍內的那些,審圖沒模擬這步),不是本線幾何,未逐一查證。
- 頭社髮夾彎的挖方擋土牆(最高 8 m)上方坡面是原地形的陡坡與一道既有摺痕,從路面仰看像懸在頭上的大斜面;碰撞剖面沒有東西侵入路面上方,但觀感不理想。
- 邊溝擦到 3 棟建物邊角(≤0.10 m²);舊路面以外的 OSM 小徑(非本線)仍是舊的貼地條帶,部分在坡上看得到。
- 路線本身:寺廟代理的文武廟 pad 規格尚未合併;合併後需依 §3 重跑一次並重做驗收。
9. 授權
- OpenStreetMap © OpenStreetMap contributors,ODbL 1.0(線形、名稱、標籤)。
- 內政部 20 m DTM:政府資料開放授權條款(第 1 版)。
- Poly Haven 貼圖:CC0。
- Noto Serif TC:SIL Open Font License 1.1。
- 管理處網頁:只取路線事實與公告文字,沒有複製圖片。
10. 檔案
- 資料:
walk/assets/bike-loop.json(764 KB)、walk/assets/terrain-edited.json、data/processed/terrain-edits/bike-loop.terrain.json、data/processed/terrain-edits/bike-loop-corridor.npz。
- 程式:
scripts/bike_route.py、bike_centerline.py、bike_profile.py、build_bike_loop.py、bike_corridor.py、terrain_edits.py、build_bikeway_terrain.py、bikeway_geometry.py、bikeway_lib.py、export_bikeway_collision.py、fetch_bikeway_textures.py、finalize_bike_loop.py、audit_bike_loop.mjs(原版備份 .bak_20260925)、audit_bikeway_visual.py;blender/build_bikeway.py、blender/render_bikeway.py;walk/bikeway.js、walk/tests/bikeway.test.mjs;walk/physics.js(掛鉤)。
- 資產:
walk/assets/bikeway/(116 個分塊 GLB、textures/、SOURCES.json)、walk/assets/bikeway-collision.bin、三個 *-edited* 衍生檔。
11. 路邊植被與近地面質感(2026-09-26)
- 為什麼:原本整地後的挖填方邊坡、路肩外、頭社盆地都是單色土黃面(網頁端近處只有低頻色調),而且整地帶內的樹被剔除,22 km 公路段看起來光禿。
- 植物(
blender/build_roadside_plants.py → walk/assets/roadside-plants.glb,母檔 blender/roadside-plants-v01.blend):
- Poly Haven CC0:蕨(fern_02)、禾草(grass_medium_02,調綠)、草本(nettle_plant,代表大花咸豐草一類)、闊葉雜草(weed_plant_02)。
- 本專案既有模型:姑婆芋、月桃、樟樹苗。
- 程序生成:五節芒(九月抽紅褐色穗)、麻竹叢(稈+葉簇貼圖卡)、檳榔(灰綠幹、羽狀葉、青果)。
- 尺寸依一般植物誌推估,不是逐株實測。
- 配置(
scripts/place_roadside.py → walk/assets/roadside.json+58 個 roadside/roadside-XX.bin):
- 範圍:路面邊 0.3–48 m,共 87 萬株,四層格點(路緣禾草 0.95 m、路邊 9 m 內加密 1.25 m、草本 1.9 m、高植物 5.5 m)。
- 只種在實際地形面上,路面、邊溝、擋土牆、橋、房子、鋪面、草坪上和旁邊都不種。
- 種類依環境:挖方坡多蕨與芒;樹冠下(WRI/Meta 樹冠高)多蕨、姑婆芋、月桃;開闊處芒與禾草;竹叢、檳榔依大尺度雜訊成片。
- 專用車道、棧道、橋頭兩側 12 m 內與湖岸只長矮草,保留湖景。
- 這些比例與分區是推估,不是現地植被調查。
- 近地面質感(
walk/landscape.js):120 m 內用 Poly Haven 的草地(leafy_grass)、落葉(forrest_ground_01)、紅土(red_dirt_mud_01)照片質感,依航照的局部色調調色,再接回航照;紅土只在最陡的坡面零星出現。
- 網頁端(
walk/roadside.js):
- 近景整株網格:禾草 22 m、中型 40 m、竹與檳榔 70 m 內。
- 遠景三片交叉貼圖板:中型到 150 m、高植物到 600 m。
- 每 500 m 一塊依距離下載,900 m 外釋放。
- 驗證:
walk/tests/roadside.test.mjs:
- 來源 SHA 與逐塊 SHA;
- 每種有近景網格與遠景板,面數在預算內;
- 透明貼圖帶 alpha;
- 沒有植物在路面上;
- 湖邊沒有、頭社盆地有;
- 根部貼著地形;
- 記錄可以正確解碼;
- 出處頁有每個 Poly Haven 資產。
- 缺口:
- 種類與分區是推估。
- 頭社盆地實際多是茭白筍田、水田,目前只是路邊雜草與竹林。
- 向山、九龍口的「水上」自行車道下方仍是草地(§8)。
- 植物沒有碰撞,人可以走進竹叢和檳榔。
- 手機沒測。
12. 對照實景:外觀、湖面、出生點(2026-09-26 晚)
- 為什麼:老闆實際騎的時候,從「地點 → 向山自行車道・騎單車」上車,落在離主線 126 m、沒建模的向山湖岸支線(OSM way/330540263),是一條貼在陡坡地形上的窄帶,以為自行車道就長這樣。拿實景照片對,主線本身的鋪面、欄杆、橋也都不像。
- 參考:霧痴部落格〈日月潭騎腳踏車路線推薦〉的照片(2022-02 拍攝,存在
.cache/bikeway-review/refs/,只當參考、不分發、不做貼圖),加上管理處向山段頁面的文字說明(永結橋、同心橋是白色橋樑,同心橋取邵族四手網造型;水社壩木棧道要牽車)。
出生點與名稱
- 「向山自行車道・騎單車」改在主線 12 m 處上車,面向同心橋(
main.js 用 bikeLoop.stationAt 算,不再寫死座標)。
- HUD 路段名:OSM 把 0–5 km 都叫「月潭自行車道」,照管理處分段改成「日月潭自行車道・向山段」(0–3.34 km)和「・水社段」(3.34–6.4 km)。管理處的「月潭段」是向山往南、經月牙灣到環湖一號隧道口那段,公告禁騎,不在主線上。
- 地名「向山・月潭自行車道北口」只改顯示名,改成「向山自行車道起點(向山遊客中心旁)」;
bike_route.py 的路由鍵不動。
外觀(scripts/bikeway_geometry.py)
- 專用自行車道(伊達邵段除外):
- 淺灰鋪面:Poly Haven clean_asphalt,底色由
scripts/make_bikeway_textures.py 調亮成平均 sRGB 150。
- 兩側 24 cm 紅磚收邊。
- 沒有標線、沒有自行車圖示(照片上都沒有)。
- 欄杆:
- 自行車道:深綠直條鋼欄杆(直條是透明貼圖
rail-bars.png,12.5 cm 一支)、上下扁鐵、木扶手,每 2 m 一根柱。
- 永結橋、同心橋:白柱,每 1.6 m 一根,加水平鋼索(
rail-cables.png,5 條)和木扶手。
- 橋面改成灰鋪面加紅磚收邊,不是木棧。
- 同心橋:兩道交叉的白色拱,從橋的四個角升到跨中,拱頂約 8 m,交叉處有一個套環,吊索拉到兩側扶手。
- 永結橋:拿掉白色橋墩,改成橋面下一道白拱,每 2 m 一根撐桿。
- 燈柱:自行車道用深綠燈柱加燈籠型燈頭;公路段不變。
- 以上尺寸(磚寬、欄杆高、直條間距、拱高)都是推估。
- 伊達邵段(2023 年新建)沒有照片可對,鋪面和標線照 OSM;欄杆也用深綠直條,是推估。
- 材質:網頁端
bikeway.js 的 materialLibrary 支援兩個新欄位:
image:整張貼圖(透明);
diffuse:換掉底色圖。
透明材質在有 MSAA 時用 alpha-to-coverage,遠處欄杆會淡成一層網,不會突然消失;沒有 MSAA 時硬裁切。
地形:水社壩平鋪、橋下是水(scripts/bike_corridor.py)
- 水社壩木棧道(
GROUNDED,前後各多 8 m)照照片平鋪在草地上:
- 地形填到棧道面下 12 cm;
- 兩側各留 3 m 平台,再以 1:3 草坡接回;
- 落差超過 1 m 才加欄杆,結果全段沒有欄杆。
- 湖面怎麼判(
lake_polygon()):OSM 日月潭多邊形(relation/3858334)∩ 園區湖面網格。
- 官方蓄水範圍(等於湖面網格)在水社把整個停車場算成湖。第一版直接用它,路邊挖出一條護城河,已改。
- 用航照分辨水陸試過,行不通:森林、屋頂會被判成水。
- 橋與棧道兩側路廊帶內、湖面多邊形內:降到湖床。
- 邊緣水深 0.25 m,往內每公尺加深 0.45 m,最深 1.5 m。
- 湖內低平地(
lake_flat_pads()):46 塊 pad,共 8.3 ha,降到水面下 0.65 m。
- 條件:OSM 湖內、原地形高出湖面 2.5 m 以內;
- 範圍:橋與棧道 120 m 內、主線 60 m 內;
- 避開建物(4 m)和路面路肩外 1 m。
- 為什麼:20 m DTM 把近岸水面抹成緩坡,向山段水上自行車道原本兩側都是草地,北端還有一片灰白淤灘。
- 擋土牆和護欄照降低後的地面重新設計。
bake_lake_depth.py 改讀 edited 地形。
- 水上自行車道和住家之間:2023 航照是綠地,OSM 與管理處說明(架在潭水上、繞過住家)是水,目前照後者。
轉角:修圓+外側加寬(bike_corridor.widen_bends())
- OSM 把直線段直角相接,專用車道有 6 處點狀折角,局部半徑只有 1–3 m:
- 向山 0.5 km、水社 2.76/2.91/2.95 km、九龍口 11.7 km(水上棧道約 160° 迴轉)、伊達邵 12.3 km。
- 自動騎乘在 0.5 km 的直角彎卡住:車往外偏、撞上外側欄杆。
- 第一版兩側一起加寬,內緣在折角處自己折疊。0.5 km 在下坡上,重疊的路面在剖面稽核裡變成 14 cm 階差。
- 改成兩步:
1. 先把轉角修圓到半徑至少 4 m(
fillet_kinks():折角附近幾站做拉普拉斯平滑)。中心線最多偏離 OSM 4 m,實際移動 0.5–1.4 m,九龍口 3.6 m。
2. 再加寬外側:6 m 弦長換算的平均半徑 4 m 以下,外緣多 1.5 m,到 10 m 漸變歸零;中心線往外移一半,內緣不動。接公路的地方淡出,不會跳。
- 結果:
- 專用車道半寬與局部半徑的比值最大 0.69(修圓前 1.72,原本就已折疊)。
- 剖面沒有超過 12 cm 的階差。
- headless Chrome 自動騎乘 7 個急彎(0.47、2.74、2.88、4.9、11.65、12.28 km,以及 28.93 km 跨過起終點),都沒卡住、沒偏出路線。
- 沒動到的:公路(台21、台21甲)急彎內側一樣有折疊,但剖面稽核沒有階差,這次沒處理。
路邊植物(scripts/place_roadside.py)
- 專用車道、棧道、公園段兩側 12 m 內只長短草,而且留 45%(原本還有闊葉雜草,水社壩草坪上看起來像姑婆芋)。
- 根部不能落在湖面高度(新湖岸邊有一株根部低到 -15.10,測試抓到)。
- 共 805,208 株。
產物
- 母檔
blender/lake-bikeway-v06.blend(54.0 MB)。v02–v05 是調整時的本機草稿,不上架。
- 58 塊分塊:LOD0 1,362,384 面、8.16 MB,單塊最多 77,400 面;LOD1 192,910 面、1.69 MB。
- 碰撞 207,360 面。
- 地形整地區 1.74 km²,新地形 421,230 面。
- 護欄:左 9,095 m、右 23,504 m。
- 貼圖:新增 clean_asphalt(CC0,3 張)和 3 張自製/衍生圖。
- 整串重生:
bash scripts/rebuild_bike_loop.sh <draft|vNN> [標籤],約 12 分鐘,記錄在 .cache/bikeway-review/rebuild-<標籤>/。
驗收
- 整圈模擬騎乘(
node scripts/audit_bike_loop.mjs --sim --dir both --runtime --walk;--runtime=網頁實際載入的 15 層碰撞加剔樹):
- 順時針、逆時針各 28,988 m,事故 0。
- 剖面 43,173 點:破洞 0、超過 12 cm 的階差 0。
- 步行 5 段全部走完。
- 驗收的坑:
--legacy 會連路廊剔樹一起關掉,會撞樹「卡住」52 次,是假警報。
- 舊驗收只用 12 層碰撞,漏掉文武廟、機車、補碰撞三層。
- 視覺稽核(
audit_bikeway_visual.py):
- 穿模 1 點(s=3,390,1.6 cm,§8 舊問題)。
- 沒有欄杆的落差:全部在水社壩,最大 0.2 m(棧道邊緣到草地)。
- 瀏覽器(本機預覽、桌機 Chrome):
- 從選單上車,照 HUD 路段名和環湖進度騎。
- 在前景的瀏覽器用自動騎乘騎完 0–5.24 km(向山段、同心橋、永結橋、水社壩、水上自行車道、水社到朝霧碼頭)。
- 一次卡住:504 m 的直角彎。改了控制器(先減速)之後 headless 仍卡在 505 m,實際原因是 OSM 折角太急,已修圓並加寬外側(見上方「轉角」)。
- 視窗被遮住時 Chrome 降到 1 FPS,整圈改用 headless Chrome(RTX 3080)騎,結果見 TASK.md。
- 看過的畫面:向山起點、同心橋、永結橋、水社壩、水上自行車道(騎在上面看、往湖看、俯瞰)、水社 2.9 km、九龍口、伊達邵水上自行車道、台21甲。
缺口
- 水社碼頭西側小灣(s≈2,920–2,960):航照上水到路邊,但 OSM 湖岸離路 20–30 m,DTM 又比湖面高 1 m 左右,所以路邊仍是一片帶航照水色的平地。
- 同心橋、永結橋橋下的溪口挖成圓池,岸邊有一圈泥色。
- 水上自行車道靠住家那側,挖出的坡面帶著屋頂的航照色(偏粉紅)。實際上應是住家的擋土牆。
- 公里牌(照片上的「0K+600」黃牌)沒放:起點和間距沒查證。
13. 路口支線與湖底(2026-09-27,v07)
老闆在 5.28 km 水社段截圖問「步道到這邊就斷掉了?正常嗎?」。
路線本身是對的
- 水社段專用車道到九龍口(4,975 m)就結束。官方環潭路線接著走台21中正路,跟汽車共用約 6.5 km。
- 管理處原文:「自行車道尚未串接完成,建議可沿著環潭公路騎乘」。
錯的是路口
- 九龍口的中正路一開始就是方頭。到台21三岔路口還有 57 m,模型裡沒有。
- 伊達邵(11.6 km,約 80 m)、向山中山路(29.0 km,約 116 m)也一樣。
- 原因:v06 的剔除範圍把主線走過那條路的整條舊路帶都剔掉了,舊路層在路口外被一刀切掉。
做法(bike_corridor.road_stubs() → terrain_edits.StubEdit)
- 每條接上或離開主線的道路(跳過登山步道):
- 從最近平面段的路面邊緣起坡,照坡度上限接到路廊外的原地面。
- 坡度上限(推估):台21 8%,其他 10–14%。
- 最長 90 m,或到路廊外 2 m。
- 全圈共 89 條。
- 舊路層照 v06 的範圍剔除,只在支線帶上把舊路面裁回來(
clip_triangles(keep='inside')),並貼到新地面 +6 cm。
- 斜貼主線的支線,支線帶會蓋到主線的路肩和邊坡。那裡地面跟支線剖面差 25 cm 以上的碎片不鋪回去。
- 支線口不設擋土牆與護欄。
湖底加深(scripts/deepen_lake_bed.py,同時為了游泳)
- 模型湖底原本只在水面下約 1 m:20 m DTM 量到的是水面。
- 改成「離水線越遠越深」的推估湖床:
20 × (1 − e^(−d/60)) m。
- 岸邊坡度約 1:3,30 m 外約 8 m,200 m 外接近 20 m。
- 這是推估,不是實測;日月潭滿水位最深約 27 m。
- 主線 12–40 m 內、水中結構物 6–25 m 內逐漸不挖,所以橋墩、擋土牆、示意深潭的底部不會懸空。
- 只往下壓、不增加三角面。
- 湖深圖跟著重烘:湖水部分中位數約 8.7 m。湖心的水色因此偏向深翠綠,淺灘的泥色只剩岸邊。
驗收
- 支線起點跟主線路面的高差全部 ≤ 0.27 m(這是橫坡)。
- 九龍口從 −7.03 以 8% 下到台21路口;向山從主線路面 −4.84 爬到原地面 −3.96。
- 恢復的舊路面只在支線上,99% 在地面 +0.2–11 cm。
- 支線以外的舊路層:只有 4 個三角形比 v06 差 20 cm 以上,267 個變好。
- 整圈剖面、雙向騎乘、步行的數字見 TASK.md。
缺口
- 向山遊客中心前,園區模型自帶的一段路(y≈0)跟主線中山路(約 −3 m)並排,高差約 3 m。v06 就有,這次沒動建築師圖面的園區模型。(v08 已處理懸空的一角,見 §14。)
- 支線上的舊路面是舊路層,遠處顏色混航照,跟主線新鋪面有色差。
- 湖床形狀是推估。
14. 效能大優化與向山路板(2026-09-27,v08)
為什麼
- 線上實測:分頁 JS 記憶體約 2.45 GB(強制 GC 後),載入到可玩約 70–98 秒,其中網路只佔 22 秒;300 km/h 繞一圈有 60 幀超過 0.1 秒、最長 3.3 秒。
- 取樣 heap 剖析:2.3 GB 在 three.js
Octree(80 萬碰撞三角形被切成 470 萬節點、1,600 萬個引用)。CPU 剖析:騎到文武廟、水社時的長幀是著色器第一次使用時同步連結(getProgramInfoLog)。
做法
- 碰撞:
walk/collision-bvh.js 扁平 BVH(中位數切分、葉 ≤ 6、全部型別陣列),介面同 Octree。三角形判定照抄 three r170。
- 著色器:
walk/shader-warm.js。載入時預編畫面與「畫進貼圖」兩版;近景模型先離場景預編再出現、貼圖每幀上傳一張;之後第一次畫的材質先跳過、背景編好再畫(FirstDrawGate)。
- 向山路板:園區模型的中山路路板(10×237 m、y≈0)西南角懸在主線邊坡上方 2–3.4 m。
terrain_edits.py 以路廊整地範圍外擴 1 m 裁掉那一角,碰撞平板同步裁;北段、其他園區物件不動。
- 路邊植物:0.4 m 城鎮航照上不是植被的地方(停車場、廣場、車、水)不種。
驗收
| 項目 |
前 |
後 |
| JS heap(載入完,強制 GC) |
2,450 MB |
61 MB |
| 載入到可玩(本機) |
70 秒以上 |
約 18 秒 |
| 碰撞建樹 |
約 70 秒 |
約 2.5 秒 |
| 300 km/h 一圈:>100 ms 的幀 |
60 |
16 |
| 300 km/h 一圈:最長一幀 |
3.3 秒 |
0.28 秒 |
| 測試整套 |
約 20 分鐘 |
約 2.5 分鐘 |
| 整圈騎乘稽核 |
67 秒 |
8 秒 |
- 射線:2 萬條隨機射線與 Octree 結果完全相同。膠囊:碰到與否完全相同;多個三角形同時接觸時推出順序不同,推出量完全一致的約 94%。整圈剖面、雙向騎乘、5 段步行的數字與 v07 相同(順時針 4,415 vs 4,416 秒)。
- 300 km/h 一圈路面始終是近景 LOD(0 幀缺路)。
- 線上(2026-09-27 部署後,headless 桌機打線上網址):載入到可玩 42 秒(v07 線上 70–98 秒,GLB 下載約 22 秒)、分頁記憶體 290–670 MB(v07 線上 2.6–4.0 GB)、300 km/h 一圈 >100 ms 的幀 17、最長 0.25 秒(都在文武廟近景 6.3–7.1 km)、主控台 0 錯誤。
14.1 載入再加速(2026-09-27 夜;2026-09-28 上線)
- 線上 v08 載入 48 秒的分解:前 13.5 秒只在一個接一個抓約 30 個小 JSON(每個來回 0.3 秒);3D 模型(.glb)Cloudflare 不快取,回原站約 2 MB/s;主執行緒 8 秒在等著色器同步編譯(載入中每幀照畫被載入卡蓋住的場景)。
- 做法:JSON 與模型一開始全部一起發;建站時每個模型、天空、碰撞另出 gzip 壓縮副本
.gz.bin(Cloudflare 會快取 .bin,684 → 272 MB),瀏覽器解壓;載入中不畫場景;樹木清除區改網格;預編閘門補陰影裝扮、無霧、共用程式、收尾佇列、同時最多 2 批;文武廟近景同檔貼圖共用。
- 驗收(本機 headless 桌機,新舊交替各 4 趟 300 km/h 一圈;這台機器顯示卡同時被別的程式佔用,單趟差異大):
| 項目 |
舊(v08 閘門+載入中照畫) |
新 |
| 載入到可玩 |
18.5–27.0 秒 |
9.2–11.4 秒(建站壓縮版 10.3 秒) |
| 一圈 >100 ms 的幀(中位數) |
約 29 |
約 21–24 |
| 文武廟一帶顯示卡記憶體(全機) |
6.7 GB |
5.8 GB |
- 兩版都偶發數秒停頓(新 2/4 趟、舊 1/4 趟;位置不固定、發生時閘門閒置),當時判斷是機器顯示卡被佔用;原因後來找到了,見 §14.4。
- 上線後(headless 桌機,網路是測試機自己的線路,約 10 MB/s):到可玩三趟 24.1、25.6、17.1 秒(v08 為 48 秒),下載 174 MB,大檔全部同時下載、壓縮副本 Cloudflare HIT;300 km/h 一圈 0 錯誤、>100 ms 40 幀,其中一次 7.3 秒停頓(9.5 km,閘門閒置)。
- 建站壓縮版與原始碼版等待 90 秒後場景相同(947 個物件、6,127,320 個三角形、碰撞 805,046 個三角形)。
14.2 載入第三輪(2026-09-28 已上線)
- v09 上線後在本機用限速 10 MB/s 的 HTTP/2 測試伺服器重現線上載入(到可玩約 20–21 秒,跟線上 17–26 秒一致),再拆:前 15 秒下載、主執行緒幾乎閒著;下載完後約 6 秒全在算。
- 算的那 6 秒裡最大塊不是 JavaScript:Chrome 追蹤顯示顯示卡程序 13 條編譯執行緒在「準備碰撞 → 可以騎」之間合計 41 秒 CPU 在做 D3D 像素著色器編譯。104 支程式一半是畫進貼圖的版本(湖面倒影、玻璃折射)。
- 做法:開場只編畫到螢幕的版本,畫進貼圖的在可以騎之後背景編;圖片改背景解碼(載好後不再卡 3.4 秒);碰撞 BVH 在 worker 建;碰撞過濾、樹木矩陣、環湖最近點三處純計算加速;樹冠高度與城鎮地面和航照同時下載。
- 驗收(本機 headless 桌機,新舊交替各 3 趟;基準是線上 v09 的程式碼、同一台測試伺服器):
| 項目 |
v09 |
新 |
| 到可玩 |
19.9–21.3 秒 |
18.5–19.1 秒 |
| 可以騎後第一幀(畫面能回應) |
22.4–23.8 秒 |
19.4–20.0 秒 |
| 「準備碰撞 → 可以騎」 |
約 3.7–3.9 秒 |
約 2.4 秒 |
| 顯示卡編譯執行緒在上面那段的工作量 |
41 秒 CPU |
20 秒 CPU |
- 場景指紋相同(947 物件、6,127,320 三角形、碰撞 805,046、BVH 節點與校驗和、99,719 個樹木實例與矩陣校驗和、338 張貼圖與像素數);六個視點截圖只有竹葉擺動與湖面波紋不同,倒影齊全。
- 300 km/h 一圈(各 3 趟交替):新版 0 錯誤;每圈幀數 16.5k/21.0k/17.2k(舊 22.3k/16.3k/17.1k),>50 ms 438/297/289(舊 107/559/355),>100 ms 11/27/17(舊 6/33/12),差異在這台共用顯示卡的雜訊範圍內;新版 3 趟裡 2 趟在起騎後約 1 秒有一幀 0.5 秒,另開追蹤跑一圈沒重現。
- 線上(2026-09-28 部署後,本機 headless 桌機):部署後第一趟(Cloudflare 快取還是冷的)到可玩 21.9 秒、可回應 22.9 秒;之後兩趟 9.7/10.3 秒、10.8/11.6 秒。這次線路比量 v09 時快(大檔 4–6 秒就下載完),所以不能直接跟 v09 的 17–26 秒比,新舊比較以上表為準。場景指紋(等 20 秒後)與本機完全相同,碰撞資料由背景執行緒建好、沒有退回主執行緒。
- 還沒做的:大模型(向山、城鎮地形、水社)都在下載的最後一秒才到,所以沒辦法趁下載時先編譯;要先讓大模型優先下載(依序而不是同時),另外列為下一步。(第四輪改用另一種做法,見 §14.3)
14.3 載入第四輪(2026-09-28 上線)
- 第三輪上線後,線上快取已熱的情況下約 5.7 秒就下載完,但之後還要算約 4.6 秒才可以騎。
- 本機(40 MB/s)逐段量:
- 最後一個大檔 4.5 秒到,航照 5.2 秒才解碼完。
- 裝模型 0.4 秒。
- 等碰撞 worker 0.7 秒,主執行緒空著。
- 編 43 支著色器 1.6 秒,其中文武廟遠景的物理材質就約 20 支。
- 可以騎之後的第一幀還要上傳 0.66 秒貼圖,主要是城鎮立面 6 張 4096² 和航照。
- 做法:
- 先到的模型一到就送出著色器編譯,不等結果也不問進度。這些模型是文武廟遠景、紀念館、Del Lago、碼頭、拉魯與電動船遠景、城鎮。結尾只剩向山、城鎮地形、水社等 12 支。
- 航照、樹冠高度、城鎮地面三張圖和描述它們的 JSON 一起開始下載。原本要等 scene.json 等檔驗證完才發出,線上約 4 秒才開始抓。
- 等碰撞 worker 的空檔先把貼圖傳上顯示卡,大的先傳,worker 一回來就停。
- 驗收(新舊交替各 3 趟,基準是線上 v10 的程式碼;40 MB/s 那組另加 1.5 秒 JSON 延遲,模擬線上 JSON 要回原站):
| 項目 |
v10(線上) |
新 |
| 到可玩(40 MB/s) |
7.39 秒 |
6.86 秒 |
| 畫面能回應(40 MB/s) |
8.13 秒 |
7.02 秒 |
| 到可玩(10 MB/s) |
18.6–19.0 秒 |
18.1–18.3 秒 |
| 畫面能回應(10 MB/s) |
19.3–19.8 秒 |
18.2–18.5 秒 |
| 結尾要編的著色器 |
43 支、約 1.6 秒 |
12 支、約 0.7 秒 |
| 可以騎後第一幀的貼圖上傳 |
0.66 秒 |
0.14 秒 |
- 建好的正式版:場景指紋和線上程式碼逐項相同。
- 300 km/h 一圈 0 錯誤,超過 100 ms 的幀 11 次(舊版 13 次)。
- 固定高畫質時,文武廟兩版都約 27 fps。
- 試過沒採用:
- 最後的編譯提前到等碰撞時跑:CPU 同時滿載,反而多 0.1 秒。
- 城鎮貼圖一到就上傳:向山模型的解析被拖慢 0.7 秒。
- 大模型依序下載:Cloudflare 快取是冷的時候,每個大檔都要回原站,排隊只會更慢。
- 上線後(無頭桌機,測試機自己的線路約 10 MB/s):換版後第一趟到可玩 21.2 秒(Cloudflare 回原站),之後 14.8、8.2、11.8、9.9 秒。v10 當時快取熱是 9.7、10.3 秒,差別在測試機線路的雜訊內。
- 還沒做的:三個大模型的 12 支著色器仍在結尾編。
14.4 第四輪續:偶發數秒停頓(2026-09-28 上線)
- 原因:
- 電腦忙的時候,自動畫質會一路降到「效能優先」(low),這一檔會關掉陰影。
- three 不會因為陰影開關就換著色器。但文武廟等模型的材質同時給合併批次和原本的網格用,每次畫都會重挑一次;重挑時就用「沒有陰影」的設定,在那一幀同步編出新的著色器。
- 背景編譯的閘門原本只記「這個材質編過沒」,不管陰影設定,所以放行。
- 停在 low 騎一圈:一次卡 19 秒,另有十幾次 1.5–6 秒。
- 做法:
- 閘門依陰影設定分開記。新設定下還沒編過的,先不畫,改在背景編。
- 要進出 low 時,先在背景把鏡頭內的材質用新設定編好(約 2 秒),編好才切,切的同時讓這些材質改用新的著色器。
- 用另一個陰影設定預編時,three 會把材質目前的著色器換成剛建好、還沒連結完的那支;切換前的每一幀就拿它來畫,在幀內收尾(0.3–0.9 秒)。所以預編完要換回原本的。
- 另外兩項:
- cluster 合併批次分段建:每幀最多 6 毫秒,建的期間原本的網格照畫。
- 等碰撞計算前,整個場景先送出著色器編譯(不等結果):裝好到第一幀 2.2–2.5 → 2.1 秒。
- 驗收:
| 項目 |
舊 |
新 |
| 畫質選單切到 low 的最長一幀 |
5.0 秒 |
0.18 秒(約 2 秒後生效) |
| 機器被佔滿時 300 km/h 一圈的最長停頓(各 2 趟,都掉到 low) |
19.0、8.0 秒 |
1.1、0.75 秒 |
| 同上,超過 3 秒的停頓 |
6、2 次 |
0、0 次 |
| 文武廟那段超過 150 ms 的幀(各 1 趟) |
6 |
2 |
- low 畫質的截圖(水社碼頭、文武廟)兩版相同;建好的正式版場景指紋和上一版逐項相同。
- 上線後:畫質切到 low 最長一幀 0.19 秒、1.8 秒後生效,0 錯誤。
- 量測時踩到:A/B 用的測試版若讓 main.js 和 cluster-lod.js 用不同網址載入 shader-warm.js,瀏覽器會載入兩份,新版整圈幀數看起來少 14%;網址對齊後兩版相同。
- 還沒做的:
- 切到 low 要等約 2 秒。
- 不在鏡頭內的物件切換後晚幾幀才出現。
- 文武廟那段在顯示卡被佔用時重量,兩版都整段約 5 fps。分段建的效果要在乾淨的機器上再量。
14.5 文武廟效能大優化(2026-09-29 上線)
- 原因:
- 瓶頸在電腦送繪製指令,不在顯示卡:解析度降到 1 倍,每秒格數不變。後山一幀約 1,340 筆繪製,文武廟近景佔 520 筆、陰影再 221 筆。
- 近景八塊各自帶一份材質,共 455 個,實際只有 179 種;合併時每塊每種材質各一批。
- 三個全湖都在付的成本:three r170 的合併批次每次畫都重新挑著色器(查錯屬性名稱);8,400 個物件的位置矩陣每幀被迫重算兩次;看不到湖的地方也每幀重畫湖面倒影。
- 做法:
- 補上合併批次的屬性、矩陣一幀只算一次(不會動的模型凍結)、湖面用遮擋查詢判斷有沒有畫到,沒畫到時倒影半秒才更新。
- 文武廟八塊相同的材質共用;八塊依序下載,到齊後當一整組合併(194 批),排在合併佇列最前;合併好之前顯示遠景,步行進入廟區時例外(殿內只有細節模型有)。
- 合併的準備工作分到很多幀:預先上傳、分批送給背景執行緒、跳過已編過的著色器。
- 驗收(本機 RTX 3080,基準是線上版的建站檔):
| 視點(高畫質 1600×900) |
線上版 |
新版 |
| 牌樓前 |
11 fps |
90 fps |
| 廟埕巨獅 |
18 fps |
111 fps |
| 拜殿內 |
15 fps |
100 fps |
| 武聖殿內 |
25 fps |
109 fps |
| 大成殿內 |
30 fps |
125 fps |
| 後山櫺星門 |
12 fps |
68 fps |
| 觀景台 |
32 fps |
120 fps |
| 項目 |
線上版 |
新版 |
| 跳到後山到細節模型合併完成 |
70 秒 |
20 秒 |
| 40 km/h 騎過文武廟,超過 50 ms 的幀 |
302 |
25 |
| 同上,最長一幀 |
591 ms |
152 ms |
| 同上,第二趟(都載好了) |
242 |
1 |
| 300 km/h 整圈的幀數 |
26,644 |
38,412 |
| 同上,超過 100 ms 的幀 |
11 |
4 |
- 截圖與線上版相同(文武廟七處、其他八處);水社碼頭倒影相同,背對湖再轉過來第一格倒影就正確。
- 量測時踩到:太陽位置跟著真實時間走,隔一小時截圖牌樓的金字從金色變粉色,要前後緊接著截兩版才能比。
- 還沒做的:八塊載入那 2–3 秒仍有幾格 0.1–0.15 秒;後山看得到整座廟加湖,每秒 48–72 格;手機未測。
14.6 文武廟效能第二輪(2026-10-01 做,10-02 上線)
- 原因:跳到廟裡之後,細節模型到齊還要再合併十幾秒,這段殿內一幀約 36 ms。拆開量,合併時間大半不是在算,而是「每幀只做 6 ms」被慢幀拉長;近景八塊又各自解碼同一套貼圖,其中 153 張遠景早就載過。
- 做法:
- 近景直接用遠景已解好、已在顯示卡上的貼圖,八塊之間也共用:解碼 624 → 105 次。
- 合併時每個零件的範圍改在背景執行緒算好,主執行緒建批次的工作少三分之二。
- 合併後要用的著色器,趁背景執行緒在簡化時先用替身編好(只對訪客正走進去的文武廟這樣做;開場其他場景也這樣做時,顯示卡編譯排太滿,反而卡出 1 秒以上的幀)。
- 八塊模型檔同時下載、依序解析;背景簡化的程式小幅加速(結果逐位元相同)。
- 驗收(本機 RTX 3080,高畫質 1600×900,基準是線上版的建站檔,新舊交替各三趟):
| 項目 |
線上版 |
新版 |
| 跳到拜殿,細節模型到齊 |
5.3–5.5 秒 |
3.6–5.0 秒 |
| 同上,合併完成 |
16.9–18.0 秒 |
10.5–12.1 秒 |
| 近景多佔的顯示卡記憶體 |
約 1,030 MB |
約 600 MB |
| 40 km/h 騎過文武廟,超過 100 ms 的幀 |
5–7 |
1 |
| 同上,最長一幀 |
162–169 ms |
101–115 ms |
| 同上,平均每秒格數 |
97–107 |
113–121 |
- 截圖:文武廟七處等合併完成後截,拜殿、武聖殿逐像素相同,其餘只差在被風吹動的竹子和陰影邊緣。
- 還沒做的:背景簡化仍約 5 秒(下一步是分給幾個背景執行緒並行);合併完成前殿內仍約每秒 28 格;同時下載只在本機驗過;手機未測。
缺口
- 文武廟:八塊載入那 2–3 秒仍有幾格 0.1–0.15 秒(見 §14.5)。
- 伊達邵水上自行車道旁一條白色地面:航照上的白色棧道落在模型路邊(OSM 路線偏 5–8 m),屬資料對位,未修。
- 手機的氮氣按鈕與整體效能未在真機測。