Choisir 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.

Étudier l’exemple Chalk Dune Dawn. Télécharger 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.
ApprocheApp minimaleCe que vous fournissez
Atmosphère + étalonnage du relief (daySky, panoramaGrade, light)1.4.9Un 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.10Ajoute 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.dayNight1.4.11Permet à une plage à ressac calculé ou aux cartes de zones vidéo de suivre le même fondu jour/nuit.
Pourquoi 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

Utiliser votre propre ciel peint au lieu du ciel procédural de Locus. Peignez 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

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.locusplace

Le 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.

  1. Importer sur Apple Vision Pro via Places → Import → Import a View → Files et associez la View à une pièce.
  2. 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.
  3. Vérifier Mouvement désactivé / Réduire les animations : vérifiez que la View se fige proprement à startHour.

Règles de coexistence et limites