Fortgeschritten · Package v2
Tag-und-Nacht-View erstellen.
Machen Sie aus einem sonnenfreien 360°-Panorama einen 24-Stunden-Ort: wanderndes Sonnenlicht und Himmelsatmosphäre, Sterne und Mond bei Nacht, abgestuftes Gelände und optional ein nach Sonnenuntergang überblendetes Vollbild-Nachtpanorama.
Erfordert Locus 1.4.9 – 1.4.11 oder neuer · Vollständiges Package v2Ansatz 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.
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.| Ansatz | Min. App-Version | Was Sie erstellen |
|---|---|---|
Atmosphäre + abgestuftes Gelände (daySky, panoramaGrade, light) | 1.4.9 | Ein 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.10 | Fü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.dayNight | 1.4.11 | Lässt berechneten Strand-Wellengang oder Videobereichs-Karten demselben Tag/Nacht-Übergang folgen. |
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
- Tagespanorama (
panorama.path): Ein 2:1-äquirektanguläres JPEG oder PNG (z. B.8192×4096oder12288×6144), bei klarem Tageslicht beleuchtet und vollständig frei von einer gemalten Sonne oder Sonnenblendung. - Sonnenfreies Raumlichtbild (
environment.imageBasedLight): Ein separates 2:1-JPEG oder -PNG (empfohlen1024×512empfohlen), ebenfalls frei von einer gemalten Sonne. - Himmelsmaske (
sky.mask): Ein 2:1-8-Bit-Graustufen-PNG (PNG-Farbtyp 0), ausgerichtet am Panorama. Malen Sie den freien Himmel weiß (255), Land, Bäume und Gebäude schwarz (0) mit sauberen, geglätteten Kanten entlang von Horizont und Ästen. - Optionale Sonnenscheiben-Maske (
environment.sunPath.disc.skyMask): Ein 2:1-8-Bit-Graustufen-PNG (max. Breite4096), in der Weiß die wandernde Sonnenscheibe hinter Vordergrundkanten durchlässt. - Deckungsgleiches Nachtpanorama (
panoramaBlend.path, für 1.4.10+): Ein separates 2:1-JPEG oder -PNG mit der exakt denselben Pixelabmessungen alspanorama.path, wobei Horizont, Berge und Bauwerke unter Nachtbeleuchtung exakt deckungsgleich bleiben. - ASTC-GPU-Sidecars (
gpuTexturesv2, erforderlich fürpanoramaBlend): Beide umwandeln:panorama.pathundpanoramaBlend.pathZuastc-6x6-srgbKTX1-Dateien (.ktx) mit vollständigen Mipmaps und horizontaler Wiederholung umwandeln. Für jede DateisourceSHA256, Abmessungen undmipmapLevels. Das veraltete SingularfeldgpuTexturewird abgelehnt, wennpanoramaBlendvorhanden ist.
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
daySky:haze(0...1, Standard0.3) verstärkt das Aerosol-Leuchten nahe Horizont und Sonne;exposure(0.25...4, Standard1) skaliert die Anpassungskurve des Taghimmels.panoramaGrade.stops: 2 bis 16 Stützpunkte mit streng steigendenelevationDegrees(-90...90) und linearen RGB-colorMultiplikatoren (0...4). Nutzen Sie sie, um gemaltes Gelände bei Sonnenauf- und -untergang abzudunkeln und aufzuwärmen, bevor das Nachtpanorama übernimmt.light.stops: 2 bis 16 Stützpunkte für die gerichtete Raumsonne (color0...16, die mitpeakIlluminanceLux) sowie Raum-/Glas-IBL-Belichtung (ambientEV-6...6, Standard0). Fügen Sie dann"midground": truewenn die View auch ein 3D-midground.path-Modell trägt, das dasselbe gerichtete Sonnenlicht erhalten soll.panoramaBlend: Blendet weich vonpanorama.pathabdayElevationDegrees(Standard-1) zupanoramaBlend.pathbisnightElevationDegrees(Standard-12; beide im Bereich-18...10mitnight < day), gefärbt mit linearem RGBnightGrade(0...4).
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.locusplaceDer 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.
- Auf der Apple Vision Pro importieren über Places → Import → Import a View → Files und kombinieren Sie die View mit einem Room.
- 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.
- Bewegung aus / Bewegung reduzieren prüfen: prüfen Sie, ob die View sauber einfriert bei
startHour.
Koexistenzregeln und Grenzen
- Ausgeschlossene Effekte:
daySky,panoramaGrade,lightundpanoramaBlendkann nicht koexistieren mitclouds,sky.aurora, Root-water,midground.water,midground.flowingWateroder klassischem Video-media. - Erlaubte Kombinationen ab 1.4.11: Berechnete
shoreBrandung (locus.view.water.surf.panorama-blend.v1) undmedia.dayNightVideokarten (locus.view.media.day-night.v1, mit 8-Bit-RGB-lightingundemissionPNGs) werden zusammen mitpanoramaBlend. - Beide Panoramen müssen exakt dieselben Abmessungen haben. Selbst ein Unterschied von einem Pixel zwischen
panorama.pathundpanoramaBlend.pathwird abgelehnt.