Preguntas frecuentes

3D Cave Viewer es una aplicación web de código abierto que permite explorar los levantamientos tridimensionales de cuevas y cavidades directamente desde el navegador, sin instalar nada. La desarrolla Davide Brugnoni para el grupo espeleológico Buio Verticale del CAI de Gubbio y se publica bajo licencia GNU GPL v3.

Ningún modelo publicado es una reconstrucción artística: cada uno es el levantamiento real de una cavidad real, georreferenciado en el mapa y fiel en sus proporciones.

No. Basta un navegador reciente: Chrome o Edge desde la versión 90, Firefox desde la 85, Safari desde la 14, incluidos los de los teléfonos. No hay nada que descargar ni que configurar.

Además es una Progressive Web App: se puede instalar como si fuera una aplicación, y las cavidades ya visitadas siguen disponibles sin conexión. Es una comodidad real en la montaña, donde la red a menudo no llega.

GLB, que es el recomendado porque reúne geometría y texturas en un único archivo compacto; GLTF con sus recursos externos; y OBJ con sus archivos de materiales, admitido pero menos eficiente.

El visor lee modelos tridimensionales, es decir mallas, no los archivos de proyecto de los programas de topografía espeleológica. Si el levantamiento nace en un software de topografía o en CAD, hay que exportarlo antes a una malla; si viene de un escaneo LiDAR o de fotogrametría, normalmente ya tiene la forma correcta.

Los modelos exportados con el eje Z vertical en lugar de Y —algo típico de CloudCompare— se enderezan escribiendo una rotación en grados en el archivo de metadatos de la cavidad, sin volver a tocar el archivo 3D.

El proyecto incluye dos herramientas de optimización, ambas de código abierto y listas para usar: un pequeño servidor Node.js que acepta los archivos arrastrándolos al navegador, cómodo para procesar varios modelos seguidos o para mantener una instancia compartida dentro del grupo, y una única página HTML que hace exactamente el mismo trabajo dentro del navegador, sin servidor ni dependencias que instalar.

Las dos aplican compresión Draco de la geometría, fusión de vértices duplicados, eliminación de recursos no utilizados y compresión de texturas en WebP o JPEG. También convierten directamente desde OBJ: se arrastran juntos el archivo .obj, los .mtl y las imágenes de las texturas.

La versión de servidor aguanta levantamientos de hasta 5 GB: la conversión desde OBJ usa un analizador que lee el archivo por partes, y las mallas con decenas de millones de vértices se dividen automáticamente antes de la compresión, sin alterar el resultado visual.

Se crea una carpeta para la cavidad, se coloca dentro el modelo 3D y un pequeño archivo JSON de metadatos con el nombre, la carpeta, el archivo, la latitud y la longitud. La descripción y la rotación son opcionales.

El catálogo se actualiza solo leyendo las carpetas que hay: no hay panel de administración que aprender ni base de datos que gestionar. La cavidad aparece en el mapa y en la lista, y su marcador abre el visor.

Tres, en orden creciente de inmersión. En modo órbita uno se mueve alrededor del levantamiento, lo gira y lo amplía como haría con una maqueta sobre la mesa; en el teléfono, un dedo gira y dos dedos hacen zoom y desplazan.

En primera persona uno está dentro de la cavidad y se mueve con las teclas WASD o con un joystick virtual, mientras la detección de colisiones impide atravesar las paredes: es lo que devuelve la sensación física del espacio.

En realidad virtual se entra en la cavidad a escala 1:1: uno se desplaza con los sticks de los mandos, gira a saltos de 45 grados por comodidad y alcanza un punto lejano con el teletransporte de doble gatillo. Durante los movimientos más rápidos los bordes de la visión se oscurecen suavemente, para reducir el riesgo de mareo por movimiento.

Para el modo de realidad virtual sí: hace falta un visor con un navegador compatible con WebXR. En cambio no se necesita ningún software específico, ni una tienda de la que descargar nada: se abre la dirección de la cavidad en el navegador del visor y ya está.

Los otros dos modos, órbita y primera persona, funcionan en cualquier ordenador o teléfono reciente. El visor añade la escala real; no es la manera obligatoria de mirar una cueva.

Se mide: se colocan puntos sobre el modelo y se obtienen distancias tridimensionales en tiempo real, con ajuste automático a los vértices de la malla para mayor precisión, ocho colores para mantener separadas varias mediciones, unidades formateadas solas en centímetros, metros o kilómetros, la posibilidad de mover un extremo ya colocado y la exportación de la lista en CSV.

Se corta: los planos de sección en los ejes X, Y y Z se regulan con deslizadores y pueden invertirse, y seis vistas ortogonales predefinidas —planta, desde abajo, frontales y laterales— permiten pasar de una perspectiva a otra. Una barra de escala se adapta al nivel de zoom para ofrecer siempre una referencia métrica.

Se anota y se exporta: los puntos de interés con etiqueta quedan guardados para cada modelo y pueden exportarse y reimportarse en JSON, mientras que el botón de la cámara guarda la vista actual en PNG con las secciones, las mediciones, la barra de escala y el logotipo ya superpuestos, lista para un informe técnico.

Sí, y es justamente el sentido de que sea software libre. La licencia GNU GPL v3 permite a cualquier grupo u organización instalarlo, personalizarlo —nombre, logotipo, colores y textos son todos configurables— y publicar sus propios levantamientos. Las obligaciones son dos: mantener la mención del autor original y distribuir las modificaciones bajo la misma licencia.

En el servidor hacen falta PHP 7.4 o superior y Apache con mod_rewrite: la infraestructura más extendida y barata que existe, la de cualquier alojamiento compartido. No hay ningún paso de compilación que ejecutar, así que el proyecto sigue siendo mantenible incluso por un grupo sin desarrolladores.

No existe ningún servicio central al que entregar los levantamientos: cada grupo instala la aplicación en su propio servidor y publica lo que decide publicar. Los archivos se quedan donde los pone quien es su dueño.

La versión de página única del optimizador trabaja enteramente dentro del navegador: los modelos no se suben a ningún servidor externo, ni siquiera para comprimirlos. Es el camino preferible cuando un levantamiento no debe salir del ordenador.

Las anotaciones añadidas a un modelo se guardan en el navegador de quien las escribe, cavidad por cavidad, y hay que exportarlas en JSON para compartirlas: no viajan solas.