Avancé · Package v2
Créer une View jour/nuit.
Transformez un panorama 360° sans soleil en un lieu complet sur 24 heures : soleil et atmosphère mobiles, étoiles et Lune la nuit, relief étalonné et panorama nocturne plein cadre en fondu après le coucher du soleil.
Nécessite Locus 1.4.9 – 1.4.11 ou ultérieur · Package v2 completChoisir votre approche
Les Views jour/nuit s’appuient sur environment.sunPath dans une archive Package v2 complète (l’ancien fichier view.json ZIP ne prend pas ces champs en charge). Le manifeste ci-dessous suit Chalk Dune Dawn (destination.chalk-dune-dawn 1.4.0), une View de dunes de gypse 12K associant panoramas jour et nuit plein cadre, ciel clair procédural, étoiles/Voie lactée et dunes 3D de plan intermédiaire éclairées par le soleil.
destination.chalk-dune-dawn-1.4.0.locusplace (ZIP de 123,9 Mo sous Licence d’exemple Locus ; également répertorié dans place-examples.json). Nécessite Locus 1.4.10 / 1.5.0 ou ultérieur et rejoindra la Gallery publique dès la sortie de Locus 1.5.0 sur l’App Store.| Approche | App minimale | Ce que vous fournissez |
|---|---|---|
Atmosphère + étalonnage du relief (daySky, panoramaGrade, light) | 1.4.9 | Un panorama diurne sans soleil, un sky.mask séparant le ciel du premier plan, ainsi que des jalons d’élévation qui teintent le relief peint et pilotent le soleil de la pièce. |
Paire de panoramas jour/nuit plein cadre (+ panoramaBlend) | 1.4.10 | Ajoute un panorama nocturne plein cadre aligné et des sidecars astc-6x6-srgb KTX1 gpuTextures des sidecars GPU v2 pour les deux panoramas afin que montagnes, neige et rivages lointains passent à un véritable éclairage nocturne. |
Avec shore ou media.dayNight | 1.4.11 | Permet à une plage à ressac calculé ou aux cartes de zones vidéo de suivre le même fondu jour/nuit. |
sky et daySky font partie du contrat. Dans la spécification Package v2 actuelle, panoramaBlend nécessite à la fois environment.sunPath.daySky ainsi que le champ racine sky (avec sky.mask et stars ou moon). Les pixels blancs dans sky.mask affichent l’atmosphère diurne rendue ainsi que les étoiles et la Voie lactée la nuit ; les pixels noirs affichent vos panoramas jour et nuit mélangés.1 · Préparer
Préparer les images et les masques
- Panorama diurne (
panorama.path): Un JPEG ou PNG équirectangulaire 2:1 (par exemple8192×4096ou12288×6144), éclairé en plein jour et totalement exempt de soleil peint ou d’éblouissement solaire. - Image d’éclairage de pièce sans soleil (
environment.imageBasedLight): Un JPEG ou PNG 2:1 distinct (1024×512recommandé), également exempt de soleil peint. - Masque du ciel (
sky.mask): Un PNG 2:1 en niveaux de gris 8 bits (type de couleur PNG 0) aligné sur le panorama. Peignez le ciel ouvert en blanc (255), et la terre, les arbres et les bâtiments en noir (0), avec des bords nets et anticrénelés le long de l’horizon et des branches. - Masque facultatif du disque solaire (
environment.sunPath.disc.skyMask): Un PNG 2:1 en niveaux de gris 8 bits (largeur max.4096), où le blanc laisse apparaître le disque solaire mobile derrière les bords du premier plan. - Panorama nocturne aligné (
panoramaBlend.path, pour 1.4.10+) : Un JPEG ou PNG 2:1 distinct ayant exactement les mêmes dimensions en pixels commepanorama.path, en conservant exactement le même horizon, les mêmes montagnes et les mêmes structures sous un éclairage nocturne. - Fichiers sidecar GPU ASTC (
gpuTexturesv2, requis pourpanoramaBlend): Convertissez les deux imagespanorama.pathetpanoramaBlend.pathàastc-6x6-srgbfichiers KTX1 (.ktx) avec mipmaps complets et bouclage horizontal. Notez pour chaque fichiersourceSHA256, dimensions etmipmapLevels. L’ancien champ singuliergpuTextureest rejeté lorsquepanoramaBlendest présent.
sky.mask entièrement en noir (0) tout en conservant les champs racine sky et daySky déclarés comme requis. Comme le noir dans sky.mask maintient vos panoramas opaques, Locus masque le ciel bleu, les étoiles et la Lune rendus tout en conservant l’horloge 24 h, le réglage de la position du soleil dans Edit View, panoramaBlend transitions, panoramaGradeainsi que l’éclairage dynamique de la Room et du plan moyen. Omettez environment.sunPath.disc (ou passez le masque entièrement noir à disc.skyMask) pour masquer également le disque solaire et l’éblouissement, ou fournissez un autre disc.skyMask à ciel blanc distinct si vous souhaitez conserver le disque solaire mobile.2 · Manifeste
Écrire destination.json et la provenance
Définissez minimumAppVersion dans locusplace.json à "1.4.9" (sans panoramaBlend), "1.4.10" (avec panoramaBlend), ou "1.4.11" (lors de l’association de panoramaBlend avec shore ou media.dayNight).
dans destination.json, chaque sunPath View doit définir "sunFreeSky": true et inclure un composant "sun-free-sky" dans provenanceDetail:
{
"formatVersion": 2,
"id": "destination.chalk-dune-dawn",
"title": "Chalk Dune Dawn",
"panorama": {
"path": "panorama.jpg",
"projection": "equirectangular",
"width": 12288,
"height": 6144,
"initialYawDegrees": -50
},
"thumbnail": "thumbnail.jpg",
"provenance": "provenance.json",
"provenanceDetail": {
"formatVersion": 1,
"components": [
{
"component": "picture",
"aiGenerated": true,
"providers": ["Google Gemini", "OpenAI"],
"credit": "Locus",
"notes": "Procedural terrain with silhouette-locked horizon detail and night relighting."
},
{
"component": "sun-free-sky",
"aiGenerated": false,
"notes": "Azimuth-symmetric clear sky and IBL with no painted sun disc or glare."
}
]
},
"sky": {
"mask": "sky-mask.png",
"stars": {
"twilight": {"strength": 0},
"milkyWay": {"style": "realistic"}
}
},
"midground": {
"path": "midground.usdz",
"terrainEntities": ["Terrain_Dunes", "Terrain_Pan"]
},
"gpuTextures": [
{
"source": "panorama.jpg",
"path": "panorama.ktx",
"format": "astc-6x6-srgb",
"width": 12288,
"height": 6144,
"mipmapLevels": 14,
"sourceSHA256": "e938e8f8c88f868ed39ec39a3c67c60da2e11281b09f59d79a0953cf8e91154d"
},
{
"source": "panorama-night.jpg",
"path": "panorama-night.ktx",
"format": "astc-6x6-srgb",
"width": 12288,
"height": 6144,
"mipmapLevels": 14,
"sourceSHA256": "efc8fda539be7d867b2181cb8a891f61316ba84d9120d31c62bbad5f96a95e57"
}
],
"environment": {
"imageBasedLight": "lighting-ibl.jpg",
"sunPath": {
"sunFreeSky": true,
"startHour": 6.35,
"dayDurationSeconds": 7200,
"maxElevationDegrees": 55,
"peakIlluminanceLux": 2900,
"nightIlluminanceLux": 0,
"disc": {
"skyMask": "sun-sky-mask.png",
"angularSizeDegrees": 0.53,
"intensity": 1
},
"daySky": {"haze": 0.3, "exposure": 1},
"panoramaGrade": {
"stops": [
{"elevationDegrees": -18, "color": [0.015, 0.014, 0.011]},
{"elevationDegrees": 0, "color": [0.245, 0.198, 0.145]},
{"elevationDegrees": 14, "color": [0.785, 0.588, 0.36]},
{"elevationDegrees": 55, "color": [1.225, 1.108, 0.932]}
]
},
"light": {
"stops": [
{"elevationDegrees": -18, "color": [0, 0, 0], "ambientEV": -2.75},
{"elevationDegrees": 0, "color": [1.25, 0.6, 0.18], "ambientEV": 0.2},
{"elevationDegrees": 14, "color": [1.38, 0.97, 0.56], "ambientEV": 0.16},
{"elevationDegrees": 55, "color": [0.96, 0.92, 0.85], "ambientEV": -0.35}
],
"midground": true
},
"panoramaBlend": {
"path": "panorama-night.jpg",
"dayElevationDegrees": -1,
"nightElevationDegrees": -12,
"nightGrade": [1, 1, 1]
}
}
}
}3 · Calibrer
Régler les jalons d’élévation et les seuils de fondu
daySky:haze(0...1, par défaut0.3) augmente le halo d’aérosols près de l’horizon et du soleil ;exposure(0.25...4, par défaut1) ajuste la courbe d’adaptation du ciel diurne.panoramaGrade.stops: 2 à 16 jalons avecelevationDegrees(-90...90) et des multiplicateurs RVB linéairescolormultiplicateurs (0...4). Utilisez-le pour assombrir et réchauffer le relief peint au lever et au coucher du soleil avant que le panorama nocturne ne prenne le relais.light.stops: 2 à 16 jalons pilotant le soleil directionnel de la pièce (color0...16multipliantpeakIlluminanceLux) et l’exposition IBL de la pièce/du verre (ambientEV-6...6, par défaut0). Ajoutez ensuite"midground": truelorsque la View comporte aussi un modèle 3Dmidground.pathqui doit recevoir le même éclairement solaire directionnel.panoramaBlend: Effectue un fondu enchaîné depanorama.pathà partir dedayElevationDegrees(par défaut-1) verspanoramaBlend.pathjusqu’ànightElevationDegrees(par défaut-12; tous deux dans-18...10avecnight < day), teinté parnightGrade(0...4).
4 · Vérifier
Empaqueter, valider et inspecter à différentes heures
python3 tools/pack_locusplace.py --current-app-version 1.4.11 \
/absolute/path/to/MyDayNightView /absolute/path/to/MyDayNightView.locusplace
python3 tools/validate_locusplace.py --current-app-version 1.4.11 \
/absolute/path/to/MyDayNightView.locusplaceLe validateur vérifie chaque contrainte du manifeste, contrôle les deux en-têtes gpuTextures KTX1 v2 ainsi que les empreintes SHA-256, et exécute sun_free_sky_check afin de détecter tout disque solaire restant dans le panorama diurne ou l’IBL.
- Importer sur Apple Vision Pro via Places → Import → Import a View → Files et associez la View à une pièce.
- Faites glisser Sun Position dans Edit View du matin jusqu’à minuit en passant par midi, l’heure dorée et le crépuscule pour vérifier les silhouettes d’horizon, les reflets sur les vitres et les bords du masque.
- Vérifier Mouvement désactivé / Réduire les animations : vérifiez que la View se fige proprement à
startHour.
Règles de coexistence et limites
- Effets exclus :
daySky,panoramaGrade,lightetpanoramaBlendne peut pas coexister avecclouds,sky.aurora, le champ racinewater,midground.water,midground.flowingWaterou l’ancien champ vidéomedia. - Associations autorisées à partir de 1.4.11 : Champ calculé
shoreressac (locus.view.water.surf.panorama-blend.v1) etmedia.dayNightcartes vidéo (locus.view.media.day-night.v1, fournissant par vidéo des PNG RVB 8 bitslightingetemissionPNG) sont pris en charge avecpanoramaBlend. - Les deux panoramas doivent avoir exactement les mêmes dimensions. Même un écart d’un pixel entre
panorama.pathetpanoramaBlend.pathest rejeté.