Vai al contenuto

SYSTEM · 2026-11-17 · 7 MIN DI LETTURA

Three.js: cos'è, cosa ci si costruisce e come si fa girare un 3D pesante nel browser

Three.js porta il 3D in tempo reale dentro una pagina web, senza plugin. Cosa fa la libreria, quando preferiamo Babylon.js o PlayCanvas, e perché il lavoro vero è far stare un modello da 78 MB nel budget di un telefono.

Un modello 3D che si apre dentro una pagina web, si gira con un dito e risponde ai clic non ha più niente di sperimentale. Funziona su qualsiasi browser recente, desktop o telefono, senza installare nulla. Nella maggior parte dei casi, sotto c'è Three.js.

Lo usiamo da anni per viewer di prodotto, mappe navigabili, documentazione tecnica e configuratori. Qui raccontiamo cos'è, quando scegliamo altro, e soprattutto dove sta il lavoro, che quasi mai è dove ci si aspetta.

Cos'è Three.js

Three.js è una libreria JavaScript open source, con licenza MIT, che fa da strato sopra le API grafiche del browser. Il browser espone WebGL (e oggi WebGPU), che è un'interfaccia di basso livello: buffer, shader, stati della GPU. Three.js ci mette sopra i concetti con cui si ragiona davvero in 3D: una scena, una camera, delle luci, delle mesh con i loro materiali, un renderer che disegna tutto a ogni fotogramma.

Il modello mentale è quello di un motore grafico, ridotto all'essenziale. Three.js non ha un editor, non impone una struttura di progetto, non gestisce la fisica né l'audio spaziale. È una libreria, non un motore completo, e questo è insieme il suo limite e il motivo per cui è così diffusa: si inserisce in qualsiasi sito, con qualsiasi framework, e pesa poco.

Due cose sono cambiate di recente, e contano per chi decide oggi:

  • WebGPU. Three.js ha un renderer WebGPU utilizzabile in produzione, che ricade su WebGL 2 dove WebGPU non c'è. Il guadagno si vede nelle scene con molti oggetti e negli effetti calcolati sulla GPU.
  • TSL, il linguaggio di shading di Three.js: si scrivono i materiali in JavaScript e la libreria li traduce per WebGL o per WebGPU. Un materiale custom non va più riscritto due volte.

Cosa ci si costruisce

I casi d'uso che vediamo più spesso sono quattro.

Viewer di prodotto e configuratori. Il prodotto in 3D sulla pagina, con finiture e varianti da cambiare. È il caso più commerciale e anche il più delicato sui materiali: se il legno a schermo non somiglia al campione, il configuratore lavora contro chi lo pubblica.

Ambienti e mappe navigabili. Un edificio, un impianto, un campus in cui ci si muove e si clicca sui punti di interesse. Il nostro DualData nasce qui: un viewer che aggancia schede, documenti e procedure ai componenti del modello, e un editor per preparare i contenuti senza scrivere codice.

Documentazione tecnica. Il manuale ti dice cosa fare, il modello ti fa vedere dove. In un prototipo interno stiamo collegando un assistente che risponde sul manuale di service di una macchina (oltre 1.300 pagine) a un viewer Three.js: quando la risposta cita un componente, la camera ci vola sopra e il resto della macchina diventa trasparente. Il lavoro non sta nel 3D né nel modello linguistico, ma nel dizionario in mezzo, che lega i nomi del manuale ai nodi del file 3D, perché quelli esportati dal CAD non sono mai leggibili.

Scene catturate dal reale. Fotogrammetria e Gaussian splatting portano nel browser luoghi veri. Qui però, come vedremo, Three.js non è sempre la nostra prima scelta.

Three.js, Babylon.js, PlayCanvas, Unity WebGL

Scegliamo lo strumento in base al progetto. In breve:

Cos'è Quando lo usiamo
Three.js Libreria leggera, nessun editor Viewer, mappe, configuratori dentro un sito esistente; massimo controllo sul rendering
React Three Fiber Three.js scritto come componenti React Quando il 3D vive dentro un'applicazione React e deve condividerne lo stato
Babylon.js Motore web completo, mantenuto da Microsoft Progetti che vogliono fisica, GUI e strumenti già pronti in un pacchetto unico
PlayCanvas Motore web con editor online Gaussian splat interattivi e team in cui anche chi non programma deve toccare la scena
Unity WebGL Export web di un progetto Unity Quando lo stesso progetto deve uscire anche su visore o app; si paga in peso e tempi di caricamento

Il nostro viewer per Gaussian splat, per esempio, è in PlayCanvas: lo splat lo renderizzano bene in molti, il valore è renderlo navigabile e cliccabile, e lì l'editor ci fa risparmiare tempo. Per un viewer che deve stare dentro il sito di un cliente, con il suo design system e il suo framework, Three.js resta la scelta più pulita.

Il problema vero è il budget

Quando un progetto web 3D va male, quasi mai è colpa della libreria. È colpa del modello. Un file pensato per un render offline, o esportato così com'era, arriva su un telefono e lo mette in ginocchio: tempi di download lunghi, memoria video esaurita, framerate che crolla.

Il formato di riferimento è glTF, quasi sempre nella versione binaria GLB: un solo file con geometria, materiali e texture. Dentro quel file, il peso si nasconde quasi sempre nello stesso posto.

Un caso nostro. Una webapp di orientamento per un campus universitario: edifici ricostruiti da dati cartografici, ambient occlusion precalcolata per ogni palazzina, punti di interesse cliccabili. Il file model.glb pesava 78,4 MB. La geometria era già leggera (545.000 triangoli, compressi con Draco). Il 95% del peso erano texture: 113 immagini, quasi tutte a 1024×1024, di cui 83 mappe di ambient occlusion, una per edificio, che da sole facevano 56 MB.

L'ambient occlusion è un'informazione a bassa frequenza, fatta di sfumature morbide: a 256 pixel è indistinguibile da quella a 1024. Ridimensionarla, e convertire le immagini in WebP o KTX2, porta lo stesso modello in un intervallo che la nostra analisi stima tra 10 e 25 MB, senza perdita visibile e senza toccare una riga del viewer. Il lavoro si fa con gltf-transform, sul file.

Le leve sono quasi sempre queste:

  • Draco o Meshopt sulla geometria. Comprimono bene, ma raramente sono il collo di bottiglia.
  • Texture dimensionate per ruolo. Il colore di base merita più risoluzione di roughness, normali e occlusione. Una risoluzione unica per tutte le mappe è lo spreco più comune.
  • KTX2. Una texture PNG o JPEG viene decompressa nella memoria della GPU: una 2048×2048 occupa circa 16 MB di memoria video, qualunque sia il peso del file. KTX2 resta compressa anche in GPU, e su un telefono è spesso la differenza tra una scena che gira e una che si chiude.
  • Risoluzione di rendering adattiva. Invece di togliere dettaglio al modello, si abbassa la risoluzione a cui la scena viene disegnata sui dispositivi deboli. Nel viewer del campus è un parametro della scena, che si può forzare anche dall'indirizzo della pagina.
  • Meno draw call. Cento oggetti con lo stesso materiale costano molto più di un oggetto unico. Unire le mesh statiche e usare l'instancing per gli elementi ripetuti pesa sul framerate più di quasi ogni altra ottimizzazione.

Il controllo va fatto prima della consegna, sul file, con i numeri davanti: quanto pesa, quante texture, a che risoluzione, quante draw call. Per questo usiamo uno strumento interno che apre il GLB e mostra dove sta il peso.

Three.js e l'AI

Sui social girano molti video in cui un modello linguistico genera in pochi secondi una città o un fondale marino in Three.js. Sono veri, e mostrano una cosa utile: la parte di codice ripetitiva (scena, luci, camera, animazioni di base) oggi si scrive in fretta, e un prototipo che prima richiedeva una giornata si vede in pochi minuti.

Quello che il prompt non risolve è tutto il resto di questo articolo. I dati veri: un prodotto con le sue misure, un edificio rilevato, una macchina con i nomi giusti dei componenti. Il budget, cioè far girare la scena sul telefono di un cliente e non sul computer di chi l'ha generata. E l'interazione che serve a qualcuno per decidere qualcosa. Il prototipo generato è un ottimo punto di partenza, non il punto di arrivo.

Quando non serve

Se il prodotto è semplice e basta girarlo, un componente pronto come model-viewer di Google fa il lavoro con poche righe di HTML, senza scrivere una scena. Se l'obiettivo è un video, un render offline costa meno e si vede meglio. Three.js ha senso quando qualcuno deve entrare nel modello, toccarlo, cambiarlo, o trovarci dentro un'informazione.

Costruiamo applicazioni 3D per il web e per i visori a partire da dati veri: cosa facciamo con System, la piattaforma DualData, oppure scriveteci.

ALTRI ARTICOLI

HAI UN PROGETTO
SIMILE?

RACCONTACELO — TI AIUTIAMO A INQUADRARLO

PARLIAMONE →