Étude de cas · 16 novembre 2026
Baie tropicale peu profonde : transformer une View lagon en cycle jour/nuit.
Partez d’un panorama 12K sans soleil d’une baie tropicale avec eau peu profonde en temps réel, puis ajoutez un cycle solaire de 24 h, les étoiles, une heure dorée chaleureuse, les cumulus peints conservés et une occultation nette du coucher de soleil derrière les îlots — sans aucun appel payant d’API d’image.
L’eau temps réel + jour/nuit requiert Locus 1.5.1 ou ultérieur · La technique à deux masques fonctionne dès Locus 1.4.9+
1 · Base de départ
Partir du lagon sans soleil avec eau temps réel
Baie tropicale peu profonde inclut déjà un panorama 12288×6144, des sidecars GPU ASTC, la bathymétrie des fonds, une géométrie de contact du rivage calibrée et l’audio du ressac — et son ciel diurne d’origine ne comporte aucun soleil peint.
Convertissez Tropical Shallow Bay en une View jour/nuit sur 24 heures sans payer de nouvelles générations : réutilisez chaque texture de base octet pour octet, et ajoutez ciel diurne, étoiles, Voie lactée et étalonnage du coucher du soleil et de la nuit avec l’eau du lagon temps réel.
L’image de base, les masques d’eau et la géométrie de contact restant inchangés, cette mise à niveau ne nécessite aucune nouvelle génération d’image. À partir de Locus 1.5.1, les clés racines water et water.contactCalibration s’associent directement à environment.sunPath (configurant daySky, panoramaGradeet light) via la capacité locus.view.water.day-night.v1 dans le manifeste destination.json .
2 · Masque du ciel
Conserver les nuages peints au lieu d’effacer tout le ciel
Notre premier essai remplaçait tout l’hémisphère supérieur par le ciel procédural daySky en remplissant en blanc toute la zone céleste de sky.mask . Sur Apple Vision Pro, la transition jour/nuit fonctionnait parfaitement, mais tous les cumulus tropicaux avaient disparu, laissant un horizon anormalement vide.
La transition est superbe, mais tous les nuages d’origine ont disparu. Conservez les nuages peints du panorama de base, laissez les étoiles briller entre eux la nuit et évitez les liserés sombres sur leurs bords.

- N’admettre le ciel procédural que dans les trouées bleues : mesurez la pureté de bleu de chaque pixel d’origine au lieu d’un seuil de luminosité brutal, puis appliquez une rampe prudente (
smoothstep(0.36, 0.90) ** 1.15), puis ajoutez un léger adoucissement gaussien de 0,35 px sur un masque 4096×2048. Les pixels blancs (255) affichent le ciel procédural le jour et les étoiles/la Voie lactée la nuit ; les pixels noirs (0) préservent les nuages peints et leurs reflets sur l’eau. - Atténuer la brume d’horizon et boucler sans couture : gardez les cœurs brillants et denses des cumulus ainsi que la brume basse d’horizon en noir (0) dans
sky.maskafin que le ciel procédural n’entre pas en conflit avec les hautes lumières des nuages ni ne crée de contours violet foncé, puis floutez avec raccord horizontal circulaire pour faire disparaître la couture ±180°. - Projeter les rayons depuis l’œil lors du calibrage des masques : lorsqu’une View active
water.contactCalibrationavec unreferenceSkyCenterMetersnon nul (par exemple hauteur des yeux +1,3 m dans une sphère source de 80 m), reprojetez les pixels du panorama depuis cette origine oculaire en direction unitaire(yaw, elevation)avant d’écrire le masque calibrésky.maskafin qu’il s’aligne exactement sur l’échantillonnage du ciel par le shader.
3 · Transmittance solaire
Atténuer naturellement le soleil derrière les nuages épais
Si sky.mask et environment.sunPath.disc.skyMask partageaient un seul masque binaire, chaque pixel de nuage blanc bloquerait 100 % du soleil — créant un effet de découpe en carton derrière les bords fins. Séparez plutôt les deux masques.
Le soleil doit transparaître plus ou moins selon l’épaisseur des nuages : diffus et à peine perceptible derrière les cœurs denses de cumulus, et plus doux à travers les voiles fins.

Le disque solaire comme l’éblouissement solaire se multiplient en continu par le niveau de gris de disc.skyMask. La conversion de l’épaisseur optique estimée des nuages en transmittance exponentielle (exp(-2.5 * optical ** 1.2)) produit 255 dans le ciel dégagé, 115–215 sur les bords fins, 20–50 derrière les cœurs denses et 0 sur la terre et la mer. Cette technique à deux masques s’appuie sur sky.mask (1.2.4+), disc.skyMask (1.3.0+), plus daySky et panoramaGrade (1.4.9+) ; les Views sans eau peuvent donc aussi l’utiliser dès Locus 1.4.9+.
4 · Géométrie d’horizon
Empêcher la lumière du coucher du soleil de traverser les îles lointaines
Lors des tests de coucher du soleil dans le casque, l’éblouissement rasant perçait encore faiblement à travers la silhouette sombre d’une île à l’horizon. Deux causes distinctes expliquaient cet artefact :
Au coucher du soleil, la lumière semble traverser la petite île à l’horizon. Vérifiez si le masque du disque ou la parallaxe sont décalés, et corrigez la fuite.

- Aligner l’origine du disque solaire sur la parallaxe oculaire : centrer le disque solaire à l’origine (0, 0, 0) alors que l’œil calibré au contact se trouve à (0, +1,3, 0) dans une sphère finie abaissait la trajectoire apparente du coucher de soleil d’environ 0,62°. L’application de
referenceOrigincomme décalage d’origine du disque et l’agrandissement du rayon céleste près de la sphère de ciel intérieure ont rétabli un alignement exact sur l’horizon. - Occulter l’éblouissement par fragment, et non uniquement au centre solaire : auparavant, l’échantillonnage de
SkyMaskuniquement selonSunDirectionlaissait le large halo d’éblouissement déborder sur le feuillage sombre dès que le centre du soleil dépassait légèrement la crête. L’échantillonnage deFragMaskle long du rayon de vue de chaque fragment et sa multiplication par un seuil netFragSilhouettebloque complètement les fuites d’éblouissement tout en gardant un léger adoucissement de crête de 2,5 px danssun-sky-mask.pngle long des contours de l’horizon.
5 · Étalonnage des couleurs
Enrichir la chaleur de l’heure dorée et garder les nuages nocturnes sombres
Oui — la température de couleur du soleil dans sunPath évolue automatiquement avec l’élévation solaire, d’un blanc neutre net à midi vers un ambre orangé près de l’horizon. Dans notre première révision, deux facteurs atténuaient cette chaleur : le shader d’éblouissement mélangeait uniformément 60 % de blanc pur à toute hauteur, et les courbes basses dans light et panoramaGrade étaient calibrées de façon trop neutre.
Faites en sorte que la température de couleur du soleil réponde naturellement lorsqu’il descend : l’heure dorée doit paraître nettement plus chaude sur l’eau, le dessous des nuages et le sol de la Room, tout en gardant les nuages nocturnes calmes et sombres autour de la Voie lactée.

- Teinte d’éblouissement sensible à l’élévation : Locus 1.5.1 applique un mélange blanc dynamique sur les Views jour/nuit : seulement 18 % de blanc sous 2° d’élévation, puis une transition fluide vers 60 % au-dessus de 22° afin que les rayons rasants gardent leur saturation ambrée.
- Abaisser le zénith et réchauffer les paliers 0°–8° : plafonner
maxElevationDegreesà 32° et définir des courbes ambrées chaudes ([0.56, 0.35, 0.22] à 0° et [0.88, 0.58, 0.36] à 4° danspanoramaGradeetlight.stops) baigne les nuages, le scintillement de la mer et l’intérieur de la Room dans une riche lumière dorée. - Courbes nocturnes basses et froides : maintenir les paliers à -12° et -18° bas et froids ([0.0055, 0.0075, 0.0125]) dans
panoramaGradetransforme les cumulus conservés en silhouettes sombres et calmes devant les étoiles et la Voie lactée plutôt qu’en taches grisâtres. - Vérifier les sommets de nuages lumineux avant publication : les sommets blancs ensoleillés des cumulus restant intacts dans le panorama diurne, inspectez pixel par pixel les résultats de
tools/sun_free_sky_check.pypixel par pixel pour confirmer l’absence totale de soleil peint avant de définirsunFreeSky: truedans le manifeste.
6 · Fichiers
Télécharger Baie tropicale peu profonde ou adapter la méthode
Baie tropicale peu profonde est publiée en archive Package v2 d’exemple gratuite sous la Licence d’exemple Locus. Vous pouvez aussi parcourir chaque révision et fiche de métadonnées dans la Galerie.