Tropical Shallow Bay at golden hour with warm amber cumulus clouds, low sunlight over a distant islet, and shimmering shallow turquoise water

1 · Baseline

Start from the sun-free realtime-water lagoon

Tropical Shallow Bay already ships with a 12288×6144 panorama, ASTC GPU sidecars, seabed bathymetry, contact-calibrated shoreline proxy geometry, and surf audio—and its original daytime sky has no painted sun.

Prompt for your agentConvert Tropical Shallow Bay to a 24-hour day-and-night View without paying for new panorama generations: reuse every base texture byte-for-byte, add clear daylight sky, stars, Milky Way, and sunset/night grading alongside its realtime lagoon water.

Because the existing base image, water masks, and contact proxy remain unchanged, upgrading the View needs no new image generation. In Locus 1.5.1 and later, root water and water.contactCalibration pair directly with environment.sunPath (configuring daySky, panoramaGrade, and light) using capability locus.view.water.day-night.v1 inside the destination.json manifest.

2 · Sky mask

Preserve painted clouds instead of erasing the whole sky

Our first test replaced the entire upper hemisphere with procedural daySky by filling the whole sky region of sky.mask with white. On Apple Vision Pro, the day/night transition worked cleanly, but all of the tropical cumulus clouds vanished—leaving an unnaturally empty horizon.

Prompt for your agentThe transition feels great, but all of the original clouds disappeared. Keep the painted clouds from the base panorama, let stars shine between them at night, and avoid dark rims around the cloud edges.
Tropical palm island at noon under preserved painted cumulus clouds with matching cloud reflections on calm clear lagoon water

3 · Solar transmittance

Make the sun fade naturally behind thicker clouds

Sharing a single binary mask between sky.mask and environment.sunPath.disc.skyMask would make every white cloud pixel block 100% of sunlight—looking like cardboard cutouts when the sun passes behind thin cumulus edges. Split the two masks instead.

Prompt for your agentThe sun should appear dimly through clouds depending on how thick the cloud is—barely diffusing behind dense cumulus cores while shining softly through thin wisps.
Side-by-side comparison showing a muted diffuse solar glow behind a thick cloud core on the left and a clearer bright solar disc shining through thin cloud wisps on the right

Both the solar disc and solar glare multiply continuously by the grayscale value of disc.skyMask. Converting estimated cloud optical depth into exponential transmittance (exp(-2.5 * optical ** 1.2)) writes 255 in open sky, 115–215 across thin edges, 20–50 behind dense cloud centers, and 0 on solid land and sea. This two-mask technique relies on sky.mask (1.2.4+), disc.skyMask (1.3.0+), plus daySky and panoramaGrade (1.4.9+), so non-water Views can use it on Locus 1.4.9+ as well.

4 · Horizon geometry

Stop sunset sunlight from bleeding through distant islands

During sunset tests on the headset, low sun glare still glowed faintly through a dark silhouette island on the horizon. Two separate issues caused that artifact:

Prompt for your agentAt sunset, the sun seems to leak right through the small island on the horizon. Check whether the disc mask or parallax is off, and fix the bleed-through.
Comparison showing the setting sun cleanly cut at the distant islet ridge with zero glare bleed on the left and completely hidden behind the island silhouette on the right
  1. Align solar disc origin with eye parallax: centering the sun disc at world origin (0, 0, 0) while placing the contact-calibrated eye at (0, +1.3, 0) inside a finite sphere pulled the apparent sunset trajectory ~0.62° too low. Applying referenceOrigin as the disc’s origin offset and expanding the celestial radius toward the inner sky sphere restored exact horizon alignment.
  2. Occlude glare per fragment, not only at sun center: previously, sampling SkyMask solely at SunDirection let the wide glare core bleed across dark island foliage whenever the sun’s center sat slightly above the ridge. Sampling FragMask along each fragment’s view ray and multiplying by a crisp FragSilhouette gate completely blocks glare bleed while keeping a subtle 2.5 px ridge feather in sun-sky-mask.png along horizon edges.

5 · Color grading

Deepen golden hour warmth and keep night clouds dark

Yes—sun color temperature in sunPath shifts automatically with solar elevation, from crisp neutral white at noon toward orange-amber near the horizon. In our first revision, two things flattened that warmth: the glare shader fixed-blended 60% toward pure white at every elevation, and the low-angle curves in light and panoramaGrade were calibrated too neutral.

Prompt for your agentMake sure sun color temperature responds naturally as it drops—golden hour should look noticeably warmer on the water, cloud undersides, and Room floor, while night clouds should stay calm and dark around the Milky Way.
Tropical Shallow Bay at midnight showing the Milky Way and starfield through clear sky gaps between calm dark cumulus cloud silhouettes

6 · Files

Download Tropical Shallow Bay or adapt the pattern

Tropical Shallow Bay is published as a free example Package v2 archive under the Locus Example License. You can also browse every revision and metadata card in the Gallery.