Fallstudie · 16. November 2026
Tropische Flachwasserbucht: Eine Lagunen-View zu Tag und Nacht machen.
Starte mit einem sonnenfreien 12K-Panorama einer tropischen Bucht samt Echtzeit-Flachwasser und ergänze ohne bezahlte Bild-API-Aufrufe einen 24-Stunden-Sonnenpfad, Sterne, warme goldene Stunde, erhaltene Kumuluswolken und saubere Sonnenuntergangs-Verdeckung hinter fernen Inselchen.
Echtzeitwasser + Tag/Nacht erfordert Locus 1.5.1 oder neuer · Zwei-Masken-Wolkentechnik funktioniert ab Locus 1.4.9+
1 · Ausgangsbasis
Mit der sonnenfreien Echtzeitwasser-Lagune starten
Tropische Flachwasserbucht enthält bereits ein 12288×6144-Panorama, ASTC-GPU-Sidecars, Meeresboden-Bathymetrie, kontaktkalibrierte Ufergeometrie sowie Brandungs-Audio — und sein ursprünglicher Tageshimmel hat keine gemalte Sonne.
Verwandle die Tropische Flachwasserbucht ohne kostenpflichtige Neugenerierung in eine 24-Stunden-Tag-und-Nacht-View: Verwende jede Basistextur bytegenau weiter und ergänze klaren Tageshimmel, Sterne, Milchstraße sowie Sonnenuntergangs- und Nacht-Grading zum Echtzeit-Lagunenwasser.
Da das vorhandene Grundbild, die Wassermasken und die Ufer-Kontaktgeometrie unverändert bleiben, erfordert das Upgrade keine neue Bildgenerierung. Ab Locus 1.5.1 lassen sich Root- water und water.contactCalibration direkt mit environment.sunPath (mit daySky, panoramaGradeund light) über die Capability locus.view.water.day-night.v1 im Manifest destination.json .
2 · Himmelsmaske
Gemalte Wolken bewahren statt den ganzen Himmel zu löschen
Unser erster Test ersetzte die gesamte obere Hemisphäre durch prozeduralen daySky , indem wir den gesamten Himmelsbereich von sky.mask komplett weiß füllten. Auf der Apple Vision Pro funktionierte der Tag/Nacht-Übergang zwar sauber, doch alle tropischen Kumuluswolken verschwanden — zurück blieb ein unnatürlich leerer Horizont.
Der Übergang fühlt sich super an, aber alle ursprünglichen Wolken sind verschwunden. Behalte die gemalten Wolken des Basispanoramas, lass nachts Sterne dazwischen scheinen und vermeide dunkle Ränder an den Wolkenkanten.

- Prozeduralen Himmel nur in offenen blauen Lücken durchlassen: miss, wie blau und klar jeder Quellpixel statt eines harten Helligkeitsschwellenwerts ist, führe ihn durch eine konservative Rampe (
smoothstep(0.36, 0.90) ** 1.15) und gib auf einer 4096×2048-Maske eine sanfte 0,35-px-Gauß-Weichzeichnung hinzu. Weiße Pixel (255) zeigen tagsüber den prozeduralen Himmel und nachts Sterne samt Milchstraße; schwarze Pixel (0) lassen gemalte Wolken samt Wasserspiegelung unverändert. - Horizontdunst sanft ausblenden und nahtlos umschlingen: belasse dichte helle Kumuluskerne und bodennahen Horizontdunst schwarz (0) in
sky.maskdamit der prozedurale Himmel nicht gegen helle Wolkenlichter arbeitet oder dunkelviolette Ränder erzeugt, und zeichne horizontal zyklisch weich, bis die ±180°-Naht verschwindet. - Strahlen bei kalibrierten Kontaktkugeln aus Augenhöhe projizieren: wenn eine View
water.contactCalibrationmit einemreferenceSkyCenterMeters-Versatz ungleich null vorgibt (z. B. Augenhöhe +1,3 m in einer 80-m-Quellkugel), projiziere die Panoramapixel zuerst von diesem Augenursprung in Einheitsrichtung(yaw, elevation)um, bevor du die kalibriertesky.maskschreibst, damit die Maske exakt zur Himmelsabfrage des Shaders passt.
3 · Sonnentransparenz
Die Sonne hinter dichteren Wolken natürlich abschwächen
Würden sky.mask und environment.sunPath.disc.skyMask dieselbe Binärmaske teilen, blockierte jeder weiße Wolkenpixel 100 % des Sonnenlichts — wie ausgeschnittene Pappe hinter dünnen Wolkenrändern. Trenne daher beide Masken.
Die Sonne soll je nach Wolkendicke gedämpft durch die Wolken scheinen — hinter dichten Kumuluskernen nur schwach diffus und durch dünne Schleier sanft hindurchleuchtend.

Sowohl die Sonnenscheibe als auch der Sonnenglare werden kontinuierlich mit dem Graustufenwert von disc.skyMaskmultipliziert. Die geschätzte optische Wolkendichte als exponentielle Transparenz (exp(-2.5 * optical ** 1.2)) schreibt 255 für freien Himmel, 115–215 an dünnen Rändern, 20–50 hinter dichten Wolkenkernen und 0 für Land und Meer. Diese Zwei-Masken-Technik nutzt nur sky.mask (1.2.4+), disc.skyMask (1.3.0+) sowie daySky und panoramaGrade (1.4.9+), sodass sich die Technik ab Locus 1.4.9+ auch für Views ohne Wasser eignet.
4 · Horizontgeometrie
Sonnenuntergangslicht am Durchscheinen durch ferne Inseln hindern
Bei Sonnenuntergangstests auf dem Headset schimmerte das tiefe Sonnenglimmen noch schwach durch die dunkle Silhouette einer Horizontinsel. Zwei getrennte Ursachen lösten das aus:
Bei Sonnenuntergang scheint die Sonne durch die kleine Insel am Horizont hindurchzuleuchten. Prüfe, ob Scheibenmaske oder Parallaxe abweichen, und behebe das Durchscheinen.

- Ursprung der Sonnenscheibe an Augenparallaxe ausrichten: Lag die Sonnenscheibe bei (0, 0, 0), während sich das kontaktkalibrierte Auge in einer endlichen Sphäre bei (0, +1.3, 0) befand, rutschte die scheinbare Sonnenuntergangsbahn um ~0,62° zu tief. Durch
referenceOriginals Ursprungsversatz der Scheibe und die Vergrößerung des Himmelsradius bis nahe an die innere Himmelssphäre stellten die exakte Horizontausrichtung wieder her. - Glare pro Fragment statt nur im Sonnenzentrum verdecken: zuvor tastete der Glare-Shader
SkyMaskausschließlich an PositionSunDirectionab, sodass der breite Glare-Kern über dunkles Insellaub strahlte, sobald die Sonnenmitte knapp über dem Grat stand. Das Abtasten vonFragMaskentlang jedes Fragment-Sichtstrahls und die Multiplikation mit einem klarenFragSilhouette-Gate blockt Glare-Durchscheinen komplett, ohne die feine 2,5-px-Gratweichzeichnung insun-sky-mask.pngentlang der Horizontkanten zu erhalten.
5 · Farbabstimmung
Goldene Stunde wärmer abstimmen und Nachtwolken dunkel halten
Ja — die Farbtemperatur der Sonne in sunPath verschiebt sich automatisch mit der Sonnenhöhe — von klarem Neutralweiß am Mittag bis Orange-Bernstein am Horizont. In unserer ersten Revision dämpften zwei Dinge diese Wärme: Der Glare-Shader mischte bei jeder Höhe fest 60 % reines Weiß ein, und die flachen Kurven in light und panoramaGrade zu neutral abgestimmt waren.
Sorge dafür, dass die Farbtemperatur der Sonne beim Sinken natürlich wärmer wird — die goldene Stunde soll auf Wasser, Wolkenunterseiten und Room-Boden spürbar warm wirken, während Nachtwolken ruhig und dunkel rund um die Milchstraße bleiben.

- Höhenabhängige Glare-Tönung: Locus 1.5.1 nutzt bei dynamischen Tag/Nacht-Views eine höhenabhängige Weißmischung: unter 2° Sonnenhöhe nur 18 % Weißanteil mit sanftem Übergang auf 60 % über 22°, damit tiefstehende Sonnenstrahlen ihre Bernsteinsättigung behalten.
- Mittagsgipfel senken & warme 0°–8°-Stopps: Begrenzung von
maxElevationDegreesauf 32° und warm-bernsteinfarbene Kurven ([0.56, 0.35, 0.22] bei 0° und [0.88, 0.58, 0.36] bei 4° inpanoramaGradeundlight.stops) taucht Wolken, Meeresglitzern und das Innere des Room in sattes Licht der goldenen Stunde. - Kühle, dunkle Nachtkurven: die Stopps bei -12° und -18° tief und kühl zu halten ([0.0055, 0.0075, 0.0125]) in
panoramaGradeverwandelt erhaltene Kumuluswolken vor Sternenlicht und Milchstraße in ruhige dunkle Silhouetten statt diesig-grauer Flecken. - Helle Wolkenoberkanten vor Auslieferung prüfen: da sonnenbeschienene weiße Kumulusspitzen im Tagespanorama erhalten bleiben, prüfe die Ergebnisse von
tools/sun_free_sky_check.pyPixel für Pixel, um vor dem Setzen vonsunFreeSky: trueim Manifest bestätigst.
6 · Dateien
Tropische Flachwasserbucht laden oder Muster übernehmen
Die Tropische Flachwasserbucht wird als kostenloses Beispiel-Package-v2-Archiv unter der Locus-Beispiellizenzveröffentlicht. In der Galerie lassen sich außerdem alle Revisionen und Metadatenkarten ansehen.