實戰案例 · 2026 年 11 月 16 日
熱帶淺水灣:將礁湖 View 變為全天候晝夜版本。
從一張無太陽、自帶即時淺水礁湖的 12K 熱帶海灣全景出發,零付費生圖 API 呼叫,為其加入 24 小時太陽軌跡、星空、濃郁黃金時刻、保留下來的原始積雲,以及遠方小島背後俐落的日落遮擋。
即時水景 + 晝夜組合需要 Locus 1.5.1 或更高版本 · 雙遮罩保雲方案適用於 Locus 1.4.9+
1 · 基線起步
從無太陽的即時礁湖水景底圖起步
熱帶淺水灣 已內建 12288×6144 全景圖、ASTC GPU sidecar、海床水深資料、岸線接觸代理幾何體與浪濤音訊——並且原始白晝天空中 沒有手繪太陽.
把 Tropical Shallow Bay 改造成 24 小時日夜版本,同時不花錢重新生成全景底圖:逐位元組複用現有貼圖,並在即時礁湖水景之上疊加晴朗白晝天空、星空、銀河與日落/夜間調色。
由於原有的全景底圖、水體遮罩和岸線接觸代理模型全部維持不變,升級過程無需重新生成影像。在 Locus 1.5.1 及更高版本中,根層級欄位 water 和 water.contactCalibration 直接搭配 environment.sunPath (配置 daySky, panoramaGrade,以及 light),並宣告能力識別碼 locus.view.water.day-night.v1 ,並寫入 destination.json 清單中。
2 · 天空遮罩
保留原有手繪雲層,而非抹掉整片天空
我們在第一版測試裡把整個上半球都替換成了程式化 daySky ——直接把整片天空區域的 sky.mask 塗成了純白。在 Apple Vision Pro 上日夜過渡確實流暢,但原本所有的熱帶積雲都消失了——海平線上空變得空蕩蕩的,不夠真實。
日夜過渡效果不錯,但原本天上的雲沒了。我希望保留底圖原本的雲,讓夜晚的星星在雲縫之間亮起,同時別在雲邊緣出現發黑的輪廓圈。

- 只在開闊藍天空隙放行程式化天空: 衡量每個源天空像素的藍色清澈度而非直接切硬亮度閾值,讓它通過一段保守漸層(
smoothstep(0.36, 0.90) ** 1.15),並在 4096×2048 遮罩上施加輕柔的 0.35 px 高斯羽化。白色像素(255)在白天顯示程式化晴空、在夜晚透出星星與銀河;黑色像素(0)完整保留手繪雲層及其在水面上的倒影。 - 收斂地平線霧氣並消除接縫: 讓明亮厚實的積雲核心與靠近海平線的低空薄霧在
sky.mask中保持純黑(0),防止程式化天空與明亮雲頂爭搶或把薄雲尾端染出暗紫輪廓圈,然後做水平循環包裹模糊,消除 ±180° 接縫。 - 存在岸線接觸標定時依視線投射射線: 當 View 啟用了
water.contactCalibration且為referenceSkyCenterMeters設定了非零視點偏移(例如視點高 +1.3 m、位於半徑 80 m 的源球體內)時,請先從該視點原點把全景像素重投影到單位方向(yaw, elevation)後再寫入校準後的sky.mask,使之與著色器的天空取樣方向完全對齊。
3 · 日光透射
讓太陽在較厚雲層背後若隱若現、自然淡出
如果讓 sky.mask 和 environment.sunPath.disc.skyMask 共用一張硬二值遮罩,每個白色雲朵像素都會把陽光 100% 擋死——太陽從薄雲邊緣後面經過時就像剪紙片。請將這兩張遮罩拆開。
太陽要在雲背後若隱若現,具體透光程度取決於雲的厚度——厚實的積雲中心只透出微弱散射光暈,薄雲邊緣則能柔和透出日輪。

太陽圓盤與太陽眩光都會連續乘以 disc.skyMask。將估算的雲層光學厚度換算為指數透射率(exp(-2.5 * optical ** 1.2))後會寫入:開闊晴空取 255,薄雲邊緣取 115–215,厚雲中心取 20–50,實體陸地與海面取 0。這套雙遮罩方案僅用到 sky.mask (1.2.4+), disc.skyMask (1.3.0+)以及 daySky 和 panoramaGrade (1.4.9+),因此不含即時水面的 View 同樣可以在 Locus 1.4.9+ 上使用這套方案。
4 · 地平線幾何
阻止日落陽光穿透遠方的海島
在頭顯裡實測日落時,低角度的太陽眩光仍會隱約穿透地平線上一座深色小島剪影。這一現象源於兩個相互獨立的問題:
太陽下山的時候在小島那裡好像能透過去。檢查一下是不是遮罩或視差偏了,把透光修好。

- 將太陽圓盤原點與視點視差對齊: 之前把太陽圓盤放在世界原點 (0, 0, 0),而岸線接觸標定後的視點在有限球體內的 (0, +1.3, 0) 處,導致表觀日落軌跡向下偏移了約 0.62°。把
referenceOrigin作為日盤原點的偏移,並將天體半徑擴大至貼近內側天空球殼,就完全恢復了準確的地平線對齊。 - 逐片元遮擋眩光,而非只取樣太陽中心: 此前僅從
SkyMask針對SunDirection中心單點取樣,導致太陽中心略高出山脊時,寬闊的眩光核心仍會穿透下方深色島嶼枝葉。改為沿每個片元的視線方向取樣FragMask,並乘以一個清晰的FragSilhouette門控後即可徹底阻斷眩光滲漏,同時保留sun-sky-mask.png中的 2.5 px 柔和山脊羽化與清晰地平線輪廓。
5 · 色彩調校
加深黃金時刻暖色調,並讓夜雲保持深沉
是的—— sunPath 裡的太陽色溫確實會隨高度角自動變化,從正午清澈的中性白逐漸轉為近地平線時的橙琥珀色。在第一版中,有兩個因素削弱了這種暖調:眩光著色器在所有高度角都固定混入了 60% 純白,同時 light 和 panoramaGrade 裡的低仰角節點基準設得偏中性。
確保太陽隨高度下降時色溫自動自然變暖——黃金時刻在水面、雲底與 Room 地面上都要有明顯暖意,同時夜間雲層在銀河周圍保持沉穩深暗。

- 隨高度角變化的眩光著色: Locus 1.5.1 在動態晝夜 View 上改用隨高度變化的高光白混比:當太陽高度角低於 2° 時僅混入 18% 純白,之後平滑過渡到高於 22° 時的 60%,從而讓低角度陽光保留濃郁的琥珀飽和度。
- 降低正午峰值並調暖 0°–8° 節點: 限制上限:將
maxElevationDegrees設為 32°,並配置暖琥珀色曲線(0° 取 [0.56, 0.35, 0.22]、4° 取 [0.88, 0.58, 0.36],分別寫入panoramaGrade和light.stops)讓雲層、海面波光與 Room 室內浸潤在濃郁的黃金時刻暖光中。 - 沉穩低冷的夜間曲線: 把 -12° 和 -18° 色階節點保持在低冷色調([0.0055, 0.0075, 0.0125])並寫入
panoramaGrade,即可讓保留下來的積雲在星光與銀河映襯下化作沉靜的暗色剪影,而非灰濛濛的色塊。 - 發布前逐點複核明亮雲頂: 由於白晝全景圖中受陽光照亮的白色雲頂並未修改,請逐像素複核
tools/sun_free_sky_check.py的所有輸出像素,確認畫面中不存在任何手繪太陽,然後再將sunFreeSky: true寫入清單。
6 · 檔案
下載《熱帶淺水灣》或套用同款方案
《熱帶淺水灣》已作為免費範例 Package v2 封存檔依據 Locus 範例授權發布。你也可以在 Gallery 中瀏覽全部修訂版本與中繼資料卡片。