Caso práctico · 16 de noviembre de 2026
Bahía tropical de aguas poco profundas: convertir una View de laguna en día y noche.
Parte de un panorama 12K sin sol de una bahía tropical con agua somera en tiempo real y añade una trayectoria solar de 24 horas, estrellas, cálida hora dorada, cúmulos conservados y oclusión nítida del atardecer tras islotes lejanos, sin ninguna llamada API de pago.
Agua en tiempo real + día/noche requiere Locus 1.5.1 o posterior · La técnica de dos máscaras funciona desde Locus 1.4.9+
1 · Punto de partida
Partir de la laguna sin sol con agua en tiempo real
Bahía tropical de aguas poco profundas ya incluye un panorama 12288×6144, sidecars GPU ASTC, batimetría del fondo, geometría de contacto del litoral calibrada y audio de oleaje; además, su cielo diurno original no tiene ningún sol pintado.
Convierte Tropical Shallow Bay en una View de 24 horas día/noche sin pagar nuevas generaciones: reutiliza cada textura base byte a byte y añade cielo diurno, estrellas, Vía Láctea y gradación de atardecer y noche junto al agua en tiempo real de la laguna.
Como la imagen base, las máscaras de agua y la geometría de contacto permanecen intactas, la actualización no necesita generar nuevas imágenes. En Locus 1.5.1 y posteriores, las claves raíz water y water.contactCalibration se combinan directamente con environment.sunPath (configurando daySky, panoramaGrade, y light) mediante la capacidad locus.view.water.day-night.v1 en el manifiesto destination.json .
2 · Máscara de cielo
Conservar las nubes pintadas en lugar de borrar todo el cielo
Nuestra primera prueba sustituía todo el hemisferio superior por daySky rellenando de blanco toda la zona de cielo de sky.mask . En Apple Vision Pro la transición funcionó con fluidez, pero todos los cúmulos tropicales desaparecieron, dejando un horizonte extrañamente vacío.
La transición se ve genial, pero desaparecieron todas las nubes originales. Conserva las nubes pintadas del panorama base, deja que las estrellas brillen entre ellas de noche y evita bordes oscuros en su contorno.

- Admitir cielo procedimental solo en huecos azules abiertos: mide cuán azul y despejado es cada píxel del cielo en lugar de aplicar un umbral duro de brillo y pásalo por una rampa conservadora (
smoothstep(0.36, 0.90) ** 1.15) y aplica un suave calado gaussiano de 0,35 px en una máscara de 4096×2048. Los píxeles blancos (255) muestran el cielo procedimental de día y las estrellas o la Vía Láctea de noche; los píxeles negros (0) conservan intactas las nubes pintadas y sus reflejos en el agua. - Suavizar la bruma del horizonte y envolver sin costura: mantén negros (0) los núcleos densos y brillantes de cúmulos y la bruma baja del horizonte dentro de
sky.maskpara que el cielo procedimental nunca compita con los brillos de las nubes ni cree bordes morados oscuros, y desenfoca con envoltura horizontal circular para eliminar la costura ±180°. - Proyectar rayos desde el ojo al calibrar máscaras: cuando una View activa
water.contactCalibrationcon unreferenceSkyCenterMetersno nulo (por ejemplo altura ocular de +1,3 m dentro de una esfera fuente de 80 m), reproyecta los píxeles del panorama desde ese origen ocular a la dirección unitaria(yaw, elevation)antes de guardar lasky.maskpara que quede exactamente alineada con la búsqueda del cielo del shader.
3 · Transmitancia solar
Hacer que el sol se atenúe de forma natural tras nubes densas
Si sky.mask y environment.sunPath.disc.skyMask compartieran una sola máscara binaria, cada píxel de nube blanca bloquearía el 100 % del sol, pareciendo cartón recortado tras los bordes finos. Separa ambas máscaras.
El sol debe atenuarse a través de las nubes según su grosor: difuminándose apenas tras los núcleos densos de cúmulos y brillando suavemente entre los velos finos.

Tanto el disco solar como el resplandor solar se multiplican de forma continua por el valor en escala de grises de disc.skyMask. Al convertir la profundidad óptica estimada de las nubes en transmitancia exponencial (exp(-2.5 * optical ** 1.2)) escribe 255 en cielo despejado, 115–215 en bordes finos, 20–50 tras núcleos densos y 0 en tierra y mar. Esta técnica de dos máscaras solo usa sky.mask (1.2.4+), disc.skyMask (1.3.0+), más daySky y panoramaGrade (1.4.9+), por lo que las Views sin agua también pueden usarla desde Locus 1.4.9+.
4 · Geometría del horizonte
Evitar que la luz del atardecer se filtre por islas lejanas
Durante las pruebas de atardecer en el visor, el resplandor solar rasante aún se filtraba levemente a través de una isla oscura en el horizonte. Dos causas distintas provocaban ese fallo:
Al atardecer, el sol parece filtrarse a través de la pequeña isla en el horizonte. Comprueba si la máscara del disco o el paralaje están desfasados y corrige la filtración.

- Alinear el origen del disco solar con el paralaje ocular: centrar el disco solar en (0, 0, 0) mientras el ojo calibrado por contacto está en (0, +1,3, 0) dentro de una esfera finita bajaba la trayectoria aparente del atardecer ~0,62°. Aplicar
referenceOrigincomo desplazamiento de origen del disco y ampliar el radio celeste hacia la esfera interior del cielo restableció la alineación exacta con el horizonte. - Ocluir el resplandor por fragmento y no solo en el centro del sol: antes, muestrear
SkyMaskúnicamente enSunDirectiondejaba que el núcleo de resplandor se filtrara sobre la vegetación oscura en cuanto el centro del sol superaba ligeramente la cresta. MuestrearFragMaska lo largo del rayo de visión de cada fragmento y multiplicarlo por una compuerta nítidaFragSilhouettebloquea por completo las filtraciones de resplandor manteniendo un suave calado de 2,5 px ensun-sky-mask.pnga lo largo de los perfiles del horizonte.
5 · Etalonaje de color
Profundizar la calidez de la hora dorada y mantener oscuras las nubes nocturnas
Sí — la temperatura de color del sol en sunPath cambia automáticamente con la elevación solar, de blanco neutro nítido al mediodía a naranja ámbar cerca del horizonte. En nuestra primera revisión dos cosas atenuaron esa calidez: el shader de resplandor mezclaba de forma fija un 60 % de blanco puro a cualquier altura, y las curvas bajas de light y panoramaGrade estaban calibradas demasiado neutras.
Asegúrate de que la temperatura de color del sol responda de forma natural al bajar: la hora dorada debe verse notablemente más cálida sobre el agua, la base de las nubes y el suelo de la Room, manteniendo las nubes nocturnas oscuras y serenas junto a la Vía Láctea.

- Tinte de resplandor sensible a la elevación: Locus 1.5.1 usa mezcla blanca dinámica en las Views de día y noche: solo un 18 % de blanco por debajo de 2° de elevación, pasando con suavidad al 60 % por encima de 22° para que los rayos rasantes conserven su saturación ámbar.
- Bajar el pico del mediodía y dar calidez a los tramos 0°–8°: limitar
maxElevationDegreesen 32° y definir curvas ámbar cálidas ([0.56, 0.35, 0.22] a 0° y [0.88, 0.58, 0.36] a 4° enpanoramaGradeylight.stops) baña las nubes, los destellos del mar y el interior de la Room en una rica luz dorada. - Curvas nocturnas bajas y frías: mantener bajas y frías las paradas de -12° y -18° ([0.0055, 0.0075, 0.0125]) en
panoramaGradeconvierte los cúmulos conservados en siluetas oscuras y serenas frente a las estrellas y la Vía Láctea, en lugar de parches grises brumosos. - Revisar las cimas de nubes brillantes antes de publicar: como las cimas blancas de cúmulos iluminados permanecen intactas en el panorama diurno, revisa los resultados de
tools/sun_free_sky_check.pypíxel a píxel para confirmar que no hay ningún sol pintado antes de establecersunFreeSky: trueen el manifiesto.
6 · Archivos
Descargar Bahía tropical de aguas poco profundas o adaptar el patrón
Bahía tropical de aguas poco profundas se publica como archivo Package v2 de ejemplo gratuito bajo la Licencia de ejemplo de Locus. También puedes explorar cada revisión y ficha de metadatos en la Galería.