实战案例 · 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 中浏览全部修订版本与元数据卡片。