Avanzado · Package v2
Crear una View de día y noche.
Convierta un panorama 360° sin sol en un espacio completo de 24 horas: luz solar y atmósfera dinámicas, estrellas y Luna por la noche, terreno gradado y un panorama nocturno opcional tras la puesta de sol.
Requiere Locus 1.4.9 – 1.4.11 o posterior · Package v2 completoElegir 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.
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.| Enfoque | App mínima | Qué debe aportar |
|---|---|---|
Atmósfera + gradación del terreno (daySky, panoramaGrade, light) | 1.4.9 | Un 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.10 | Añ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.dayNight | 1.4.11 | Permite que una playa con oleaje calculado o mapas de regiones de vídeo sigan la misma mezcla día/noche. |
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
- Panorama diurno (
panorama.path): Un JPEG o PNG equirectangular 2:1 (por ejemplo,8192×4096o12288×6144), iluminado a plena luz del día y completamente libre de un sol pintado o resplandor solar. - Imagen de iluminación de Room sin sol (
environment.imageBasedLight): Un JPEG o PNG 2:1 separado (se recomienda1024×512recomendado), también libre de un sol pintado. - Máscara del cielo (
sky.mask): Un PNG 2:1 en escala de grises de 8 bits (tipo de color PNG 0) alineado con el panorama. Pinte el cielo abierto en blanco (255) y la tierra, los árboles y los edificios en negro (0), con bordes limpios y suavizados a lo largo del horizonte y las ramas. - Máscara opcional del disco solar (
environment.sunPath.disc.skyMask): Un PNG 2:1 en escala de grises de 8 bits (ancho máximo4096), donde el blanco deja ver el disco solar en movimiento detrás de los bordes del primer plano. - Panorama nocturno alineado (
panoramaBlend.path, para 1.4.10+): Un JPEG o PNG 2:1 separado con las exactamente el mismo ancho y alto en píxeles comopanorama.path, manteniendo exactamente el mismo horizonte, montañas y estructuras bajo iluminación nocturna. - Archivos sidecar GPU ASTC (
gpuTexturesv2, obligatorios parapanoramaBlend): Convierta ambas imágenespanorama.pathypanoramaBlend.pathParaastc-6x6-srgbarchivos KTX1 (.ktx) con mipmaps completos y ajuste horizontal continuo. Registre de cada archivosourceSHA256, dimensiones ymipmapLevels. El campo singular heredadogpuTexturese rechaza cuandopanoramaBlendestá presente.
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
daySky:haze(0...1, por defecto0.3) aumenta el resplandor atmosférico cerca del horizonte y del sol;exposure(0.25...4, por defecto1) escala la curva de adaptación del cielo diurno.panoramaGrade.stops: 2 a 16 paradas con valores estrictamente crecientes deelevationDegrees(-90...90) y multiplicadores RGB linealescolormultiplicadores (0...4). Úselo para atenuar y dar calidez al terreno pintado al amanecer o al atardecer antes de que entre el panorama nocturno.light.stops: 2 a 16 paradas que controlan el sol direccional de la habitación (color0...16que multiplican apeakIlluminanceLux) y la exposición IBL de la habitación/vidrio (ambientEV-6...6, por defecto0). Luego añada"midground": truecuando la View también incluya un modelo 3Dmidground.pathque deba recibir la misma luz solar direccional.panoramaBlend: Hace una transición suave desdepanorama.pathigual o superior adayElevationDegrees(predeterminado-1) apanoramaBlend.pathigual o inferior anightElevationDegrees(predeterminado-12; ambos dentro de-18...10connight < day), teñido por el RGB linealnightGrade(0...4).
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.locusplaceEl 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.
- Importar en Apple Vision Pro mediante Places → Import → Import a View → Files y empareje la View con una Room.
- 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.
- Comprobar Movimiento desactivado / Reducir movimiento: confirme que la View se detiene limpiamente en
startHour.
Reglas de coexistencia y límites
- Efectos excluidos:
daySky,panoramaGrade,light, ypanoramaBlendno puede coexistir conclouds,sky.aurora, la raízwater,midground.water,midground.flowingWaterni vídeo heredadomedia. - Combinaciones permitidas desde 1.4.11: Campo calculado
shoreoleaje (locus.view.water.surf.panorama-blend.v1) ymedia.dayNightmapas de vídeo (locus.view.media.day-night.v1, proporcionando mapas PNG RGB de 8 bitslightingyemissionPNG) son compatibles junto conpanoramaBlend. - Ambos panoramas deben tener exactamente las mismas dimensiones. Incluso una diferencia de un píxel entre
panorama.pathypanoramaBlend.pathse rechaza.