Ansatz wählen

Tag-und-Nacht-Views basieren auf environment.sunPath in einem vollständigen Package-v2-Archiv (das flache Kompatibilitäts- view.json ZIP diese Felder nicht unterstützt). Das folgende Manifest orientiert sich an Chalk Dune Dawn (destination.chalk-dune-dawn 1.4.0), einer 12K-Gipsdünen-View, die Vollbild-Tag- und Nachtpanoramen, prozeduralen klaren Himmel, Sterne/Milchstraße und sonnenbeschienene 3D-Mittelgrunddünen kombiniert.

Das Beispiel Chalk Dune Dawn ansehen. Herunterladen destination.chalk-dune-dawn-1.4.0.locusplace (123,9 MB ZIP unter der Locus-Beispiellizenz; ebenfalls aufgeführt in place-examples.json). Erfordert Locus 1.4.10 / 1.5.0 oder neuer und erscheint in der öffentlichen Gallery, sobald Locus 1.5.0 im App Store live ist.
AnsatzMin. App-VersionWas Sie erstellen
Atmosphäre + abgestuftes Gelände (daySky, panoramaGrade, light)1.4.9Ein sonnenfreies Tagespanorama, eine sky.mask , die Himmel und Vordergrund trennt, sowie Höhen-Stützpunkte, die das gemalte Land färben und das Raum-Sonnenlicht steuern.
Vollbild-Tag-/Nacht-Panoramapaar (+ panoramaBlend)1.4.10Fügt ein deckungsgleiches Vollbild-Nachtpanorama und astc-6x6-srgb KTX1 gpuTextures v2-Sidecars für beide Panoramen hinzu, sodass Berge, Schnee oder ferne Küsten in echte Nachtbeleuchtung wechseln.
Mit berechnetem shore oder media.dayNight1.4.11Lässt berechneten Strand-Wellengang oder Videobereichs-Karten demselben Tag/Nacht-Übergang folgen.
Warum sky und daySky Teil des Vertrags sind. In der aktuellen Package-v2-Spezifikation erfordert panoramaBlend erfordert sowohl environment.sunPath.daySky als auch Root- sky (mit sky.mask und stars oder moon). Weiße Pixel in sky.mask zeigen weiße Pixel die berechnete Tagesatmosphäre sowie Nachtsterne/Milchstraße; schwarze Pixel zeigen Ihre überblendeten Tag- und Nachtpanoramen.

1 · Vorbereiten

Bilder und Masken vorbereiten

Einen eigenen gemalten Himmel statt Locus’ prozeduralem Himmel verwenden. Färben Sie sky.mask vollständig schwarz (0), während das Root-Feld sky und daySky wie vorgeschrieben deklariert bleibt. Da Schwarz in sky.mask Ihre Panoramen deckend hält, blendet Locus den gerenderten blauen Himmel, Sterne und Mond aus und behält 24-Stunden-Uhr, Edit-View-Sonnenpositions-Scrubbing, panoramaBlend -Übergänge, panoramaGradesowie die dynamische Room-/Mittelgrund-Beleuchtung bei. Lassen Sie environment.sunPath.disc weg (oder übergeben Sie die komplett schwarze Maske an disc.skyMask), um auch Sonnenscheibe und Blendung auszublenden, oder stellen Sie eine separate disc.skyMask mit weißem Himmel bereit, falls die bewegliche Sonnenscheibe sichtbar bleiben soll.

2 · Manifest

Schreiben: destination.json und Herkunftsangaben

Setzen Sie minimumAppVersion In locusplace.json Zu "1.4.9" (ohne panoramaBlend), "1.4.10" (mit panoramaBlend), oder "1.4.11" (beim Kombinieren von panoramaBlend mit shore oder media.dayNight).

In destination.json, jeder sunPath View muss "sunFreeSky": true setzen und eine "sun-free-sky" -Komponente in 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 · Kalibrieren

Höhen-Stützpunkte und Überblendungsschwellen abstimmen

4 · Prüfen

Packen, validieren und zu verschiedenen Tageszeiten prüfen

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

Der Validator prüft jede Manifest-Bedingung, verifiziert beide gpuTextures v2-KTX1-Header und SHA-256-Prüfsummen und führt sun_free_sky_check aus, um im Tagespanorama oder IBL verbliebene helle Sonnenscheiben zu erkennen.

  1. Auf der Apple Vision Pro importieren über Places → Import → Import a View → Files und kombinieren Sie die View mit einem Room.
  2. Sun Position in Edit View verschieben durch Morgen, Mittag, goldene Stunde, Dämmerung und Mitternacht, um Horizontsilhouetten, Glasreflexionen im Room und Maskenübergänge zu prüfen.
  3. Bewegung aus / Bewegung reduzieren prüfen: prüfen Sie, ob die View sauber einfriert bei startHour.

Koexistenzregeln und Grenzen