Buio Verticale - Gruppo Speleologico CAI Gubbio

Entrare in una grotta
dal browser.

Un'applicazione web open source che apre i rilievi tridimensionali delle cavità a chiunque abbia un browser. Si gira il modello, ci si cammina dentro in prima persona, o ci si entra in scala 1:1 con un visore. Niente da installare.

Apri la demo Codice su GitHub Vai al press kit
scorri per scendere
−8 m l'idea

Il rilievo, ma percorribile.

Ogni modello pubblicato non è una ricostruzione artistica: è il rilievo reale di una cavità vera, georeferenziato sulla mappa e fedele nelle proporzioni.

Chi esplora una cavità porta con sé torce, corde e strumenti di rilievo. Chi la studia dopo si trova davanti a planimetrie su carta o file CAD che restituiscono solo in parte la complessità di quegli ambienti.

3D Cave Viewer nasce da una domanda semplice: e se chiunque potesse entrare in una cavità dal proprio browser, anche senza averla mai visitata?

L'idea è di Davide Brugnoni, speleologo del Gruppo Buio Verticale, sezione CAI Gubbio, e viene portata avanti con il sostegno di tutto il gruppo.

−22 m esplorazione

Tre modi di esplorare la stessa cavità.

Dalla stessa pagina, in ordine crescente di immersività.

mouse · touch

Orbitale

Si ruota, si ingrandisce, si studia dall'esterno come una maquette fisica. Su mobile un dito ruota la vista, due dita fanno zoom e spostano.

wasd · joystick

Prima persona

Si è dentro. Il rilevamento delle collisioni impedisce di attraversare le pareti, e lo spazio si sente: le strettoie sono strette davvero.

webxr · scala 1:1

Realtà virtuale

Con un visore si entra nella cavità a grandezza reale. Teleport sul punto puntato, rotazione a scatti e vignettatura di comfort per non star male.

−40 m lavoro sul campo

Strumenti che reggono una relazione tecnica.

Pensati per chi usa i modelli davvero: speleologi, geologi, progettisti.

csv Misurazioni 3D

Punti sul modello con aggancio automatico ai vertici, otto colori per misure parallele, unità formattate da sole ed esportazione in CSV. Una quota si verifica senza tornare in grotta.

x · y · z Sezioni e viste

Piani di taglio su X, Y e Z regolabili a cursore, sei viste ortogonali predefinite e una barra di scala che si adatta allo zoom.

json Annotazioni

Punti di interesse con etichetta, salvati per ogni cavità ed esportabili in JSON per passarli al resto del gruppo.

png Esportazione PNG

Un click sulla fotocamera salva la vista corrente con sfondo trasparente, sezioni attive, misure, scala e logo del gruppo. Pronta da impaginare.

−58 m accesso

Funziona ovunque, anche dove la rete non arriva.

Nessuna installazione

Qualsiasi browser recente, desktop o mobile. Installabile come app: le cavità visitate restano offline, con una pagina che mostra lo spazio occupato e permette di liberarlo.

Quattro lingue

Italiano, inglese, francese e spagnolo, selezionabili in ogni momento dall'interfaccia. Aggiungerne una richiede solo la traduzione di un file JSON, senza toccare il codice.

Un link, la stessa inquadratura

Il link porta con sé la posizione della camera: chi lo riceve vede la stessa vista. Ogni cavità genera anche un'anteprima social con watermark, pronta per Facebook, WhatsApp e Telegram.

Quando qualcosa va storto

Errori di rete gestiti con pulsante Riprova, blocco del caricamento intercettato in anticipo, e contesto grafico che si ripristina da solo dopo un crash. Mai una schermata nera.

−85 m destinatari

A chi serve.

Gruppi speleologici

Per archiviare e condividere i propri rilievi in una forma che si apre con un link, e per riusare la piattaforma con il proprio nome.

Ricercatori e geologi

Per studiare morfologie, misurare e produrre sezioni senza software CAD specialistici.

Scuole e divulgazione

Per portare dentro una grotta studenti e pubblico, anche in VR, senza rischi e senza attrezzatura.

Stampa e comunicazione

Per raccontare le esplorazioni con immagini ad alta risoluzione, link condivisibili e anteprime social generate da sole.

−96 m codice

Libero, e riusabile con il tuo nome.

Backend PHP senza framework, Three.js per il 3D, Leaflet per le mappe, zero passaggi di compilazione. Gira su un comune hosting PHP e può essere mantenuto da qualsiasi gruppo speleologico, anche senza un team di sviluppo.

Chiunque può adottarlo, cambiarne nome, logo, colori e testi, e pubblicare i propri rilievi.

GNU GPL v3

Come funziona la licenza

Il progetto è gratuito, ma non di dominio pubblico. La licenza GNU GPL v3 impone due regole: condividere il codice di qualsiasi versione derivata sotto questa stessa licenza, e citare l'autore linkando il repository GitHub originale. Questo garantisce che il software resti sempre libero e permette a chiunque di risalire alla fonte e ripartire da lì.

PHP 7.4+ Three.js Leaflet WebXR three-mesh-bvh Draco PWA GLB / GLTF / OBJ
Vai al repository
−102 m sostegno

Sostieni il progetto.

Il progetto è gratuito e sviluppato nel tempo libero, senza sponsor. Se ti è utile o vuoi vederlo crescere, una donazione aiuta a coprire le ore di sviluppo e l'intelligenza artificiale che mi affianca nella scrittura del codice, non l'hosting. Anche un piccolo contributo fa la differenza.

−105 m stampa

Materiali per la stampa.

Comunicato stampa, articolo di approfondimento e scheda tecnica, pronti per la pubblicazione.

Vai al press kit
−108 m contatti

Scrivici.

Se il progetto ti incuriosisce, scrivici. Compila il modulo, ti risponderemo.