# Explorar desde el suelo lunar · versión 05

La vista **Caminar por la Luna** utiliza los recortes LOLA existentes de Copérnico, Tycho y Tranquilidad / Apollo 11. La cámara queda a 1,7 metros radiales por encima de los mismos triángulos dibujados. Los pasos son de 50 metros (250 con Mayús), una distancia de exploración virtual, no una velocidad humana. Arrastrar cambia la mirada y la rueda cambia la lente entre 12° y 85°. Las flechas y WASD sólo actúan cuando el visor tiene el foco. No existe un bucle continuo de desplazamiento.

## Datos, resolución y límites

Los mapas y el datum se documentan en [luna-v04.md](luna-v04.md). Fuente primaria revisada el 20 de septiembre de 2026: [NASA SVS, CGI Moon Kit](https://svs.gsfc.nasa.gov/4720/). El DEM global de LOLA tiene 64 muestras por grado; el espaciado norte-sur de la fuente ronda los 474 metros. NASA da las alturas respecto de una esfera de radio 1.737,4 km. Se conserva ese radio y la curvatura del recorte.

El terreno disponible representa formas amplias. No resuelve huellas, piedras ni módulos de aterrizaje. La vista cercana permite experimentar el horizonte de esa malla; no constituye una reconstrucción fotográfica a escala humana. El color histórico es un mosaico adaptado para visualización. No se descargan nuevos recursos ni se cambian sus licencias; créditos y condiciones en [luna-v04.md](luna-v04.md) y [recursos-v02.md](recursos-v02.md).

Se puede recorrer el 85% central de cada semiextensión del recorte. El margen evita llegar al borde de la malla; al aproximarse al límite, una línea ámbar y el estado de la interfaz lo indican. Fuera del recorte no se inventa topografía: un fondo negro oculta el cielo bajo el horizonte de una esfera situada 100 m por debajo de la cota mínima del recorte. Montañas desconocidas fuera de la región podrían modificar el horizonte observado en la realidad.

## Coordenadas y cámara

La escena local usa kilómetros: X este, Y radial en el centro del recorte y Z sur. Cada punto de la malla corresponde a un vértice del DEM, proyectado radialmente desde un plano tangente; sus alturas no se exageran.

`sample(x,z)` interpola los tres vértices del triángulo utilizado por el renderizado, no una altura bilineal distinta. Sobre ese punto se suma `normal_radial × 0,0017 km`. De ese modo la cámara permanece por encima de la superficie incluso en laderas y al pasar de calidad detallada a ligera. La altitud publicada es radial respecto del datum, no altura sobre un supuesto nivel del mar.

## Sol, Tierra y estrellas

Para cada instante, la posición del cuerpo respecto al centro lunar se transforma del marco eclíptico J2000 al marco fijo lunar mediante la inversa de la orientación lunar y, después, al marco local del recorte. Se resta también la posición del observador: las direcciones incluyen paralaje de superficie. Las altitudes se miden respecto de la vertical radial local, sin refracción atmosférica.

El cielo se dibuja en un pase separado alrededor del observador. Situar cada esfera a una distancia gráfica `D = 100` y darle radio `D × radio_real / distancia_real` conserva su radio angular `asin(radio_real / distancia_real)`. La Tierra conserva la orientación de sus continentes y recibe luz en la dirección del Sol vista desde la Tierra y transformada al marco local. Su fase es aproximadamente complementaria de la fase lunar vista desde la Tierra: cuando desde Granada vemos una Luna casi llena, desde la Luna vemos una Tierra casi nueva. El disco terrestre ocupa aproximadamente dos grados del cielo; en una vista amplia puede verse pequeño, y la rueda permite observarlo con mayor aumento sin cambiar su tamaño físico. Los mapas de nubes y ciudades no se dibujan en este pequeño disco. Las estrellas usan el catálogo y movimiento propio existentes, con la misma transformación de orientación; sus símbolos tienen un tamaño de presentación y no reproducen la adaptación visual o una exposición fotográfica. El cielo lunar no muestra un resplandor atmosférico azul.

Primero se dibuja el cielo, se limpia sólo la profundidad y se dibuja el terreno. Las montañas visibles ocultan los cuerpos. El relieve emplea siempre luz solar en esta vista; la luz de estudio sigue disponible en la vista de relieve elevada. La pequeña luz de relleno del material y las sombras suavizadas son aproximaciones visuales; no se simulan exposición ocular, reflexión múltiple del regolito ni iluminación detallada de la Tierra sobre el suelo. Las efemérides y orientaciones conservan las limitaciones descritas para el motor del proyecto.

## Archivos y verificación

- `js/suelo-lunar.js`: cámara, interpolación, entrada, cielo y estado serializable.
- `js/escena.js`: creación diferida y selección de vista; reutiliza los recursos de `SolarTerrain`.
- `js/terreno.js`: permite superponer el terreno sobre el pase celeste sin borrar el color.
- `tests/suelo-lunar.cjs`: contacto con triángulos por intersección independiente, 3 regiones × 2 calidades, límites, estado y 18 combinaciones de fecha/región/calidad; compara direcciones, tamaños angulares y fracción iluminada terrestre con un cálculo por otra ruta en coordenadas globales. Son comprobaciones geométricas del motor, no una calibración fotométrica del brillo en pantalla.
- `tests/camaras.cjs`: verifica carga única simultánea, exclusión entre controles y retorno a vistas anteriores.

La cámara y el cielo no crean `requestAnimationFrame`, intervalos ni temporizadores. Se redibujan a petición del bucle principal o de un control del usuario.