Elegir su enfoque

Las Views de día y noche se basan en environment.sunPath dentro de un archivo Package v2 completo (el archivo plano compatible view.json ZIP no admite estos campos). El manifiesto siguiente sigue el de Chalk Dune Dawn (destination.chalk-dune-dawn 1.4.0), una View de dunas de yeso en 12K que combina panoramas diurnos y nocturnos a fotograma completo, cielo despejado procedural, estrellas/Vía Láctea y dunas 3D de plano medio iluminadas por el sol.

Estudia el ejemplo Chalk Dune Dawn. Descargar destination.chalk-dune-dawn-1.4.0.locusplace (ZIP de 123,9 MB bajo la Licencia de ejemplo de Locus; también incluido en place-examples.json). Requiere Locus 1.4.10 / 1.5.0 o posterior y se unirá a la Gallery pública cuando Locus 1.5.0 esté disponible en el App Store.
EnfoqueApp mínimaQué debe aportar
Atmósfera + gradación del terreno (daySky, panoramaGrade, light)1.4.9Un panorama diurno sin sol, una sky.mask que separa el cielo del primer plano, más paradas de elevación que tiñen el terreno pintado y controlan el sol de la Room.
Par de panoramas día/noche a cuadro completo (+ panoramaBlend)1.4.10Añade un panorama nocturno a cuadro completo alineado y sidecars astc-6x6-srgb KTX1 gpuTextures GPU v2 para ambos panoramas para que montañas, nieve o costas lejanas pasen a una iluminación nocturna real.
Con shore o media.dayNight1.4.11Permite que una playa con oleaje calculado o mapas de regiones de vídeo sigan la misma mezcla día/noche.
Por qué sky y daySky forman parte del contrato. En la especificación Package v2 actual, panoramaBlend requiere tanto environment.sunPath.daySky y el campo raíz sky (con sky.mask y stars o moon). Los píxeles blancos en sky.mask muestran la atmósfera diurna renderizada y las estrellas/Vía Láctea por la noche; los píxeles negros muestran sus panoramas de día y noche mezclados.

1 · Preparar

Preparar las imágenes y máscaras

Usar tu propio cielo pintado en lugar del cielo procedural de Locus. Pinta sky.mask completamente en negro (0) mientras mantienes en la raíz sky y daySky declarados según lo exigido. Como el negro en sky.mask mantiene opacos tus panoramas, Locus oculta el cielo azul, las estrellas y la Luna renderizados mientras conserva el reloj de 24 horas, el ajuste de posición del sol en Edit View, panoramaBlend transiciones, panoramaGradey la iluminación dinámica de Room y primer plano medio. Omite environment.sunPath.disc (o pasa la máscara totalmente negra a disc.skyMask) para ocultar también el disco solar y el resplandor, o proporciona un disc.skyMask independiente con el cielo blanco si aún quieres mostrar el disco solar móvil.

2 · Manifiesto

Escribir destination.json y la procedencia

Establezca minimumAppVersion En locusplace.json Para "1.4.9" (sin panoramaBlend), "1.4.10" (con panoramaBlend), o "1.4.11" (al emparejar panoramaBlend con shore o media.dayNight).

En destination.json, cada sunPath View debe establecer "sunFreeSky": true e incluir un componente "sun-free-sky" en 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 · Calibrar

Ajustar paradas de elevación y umbrales de mezcla

4 · Verificar

Empaquetar, validar e inspeccionar a distintas horas

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

El validador comprueba cada restricción del manifiesto, verifica ambos encabezados gpuTextures KTX1 v2 y los resúmenes SHA-256, y ejecuta sun_free_sky_check para detectar si quedó algún disco solar brillante en el panorama diurno o en el IBL.

  1. Importar en Apple Vision Pro mediante Places → Import → Import a View → Files y empareje la View con una Room.
  2. Arrastre Sun Position en Edit View desde la mañana hasta la medianoche pasando por el mediodía, la hora dorada y el crepúsculo para revisar siluetas del horizonte, reflejos en cristales y bordes de máscara.
  3. Comprobar Movimiento desactivado / Reducir movimiento: confirme que la View se detiene limpiamente en startHour.

Reglas de coexistencia y límites