# Caricare modelli 3D ([name])

I modelli 3D sono disponibili in centinai di formati, ognuno con uno scopo differente, diverse funzioni e complessità varie. Sebbene three.js metta a disposizione molti loader, la scelta del formato e del flusso di lavoro giusti farà risparmiare tempo e frustrazione in seguito. Con alcuni formati è difficile lavorare, possono essere inefficienti per le esperienze in tempo reale, o semplicemente non supportati al momento.

Questa guida mette a dispozione un flusso di lavoro consigliato per la maggior parte degli utenti, e dei suggerimenti per affrontare i malfunzionamenti nel caso in cui non funzionasse come ci si aspetta.

## Prima di iniziare

Se siete alle prime armi con la gestione di un server locale, iniziate prima di tutto a capire [link:#manual/introduction/Installation installation]. Molti errori comuni nella visualizzazione dei modelli 3D possono essere evitati gestendo correttamente l'hosting dei file.

## Workflow consigliato

Dove possibile, consigliamo di utilizzare il formato glTF (GL Transmission Format). Entrambe le versioni .GLB e .GLTF sono supportate. Il formato glTF è incentrato sulla distribuzione di asset in runtime, è compatto da trasmette e veloce da caricare. Le carattestistiche includono mesh, materiali, texture, skin, skeleton, morph target, animazioni, luci, e camera.

Modelli glTF pubblici sono disponibili su siti come Sketchfab, o vari strumenti di sviluppo di modelli includono l'esportazione glTF:

- Blender di the Blender Foundation
- Substance Painter di Allegorithmic
- Modo di Foundry
- Toolbag di Marmoset
- Houdini di SideFX
- Cinema 4D di MAXON
- COLLADA2GLTFdi the Khronos Group
- FBX2GLTF di Facebook
- OBJ2GLTF di Analytical Graphics Inc
- …e molti altri

Se i tuoi strumenti preferiti di sviluppo dei modelli, non supportano il formato glTF, considera di richiedere l'esportazione glTF agli autori, o di fare un post sul thread della roadmap di glTF.

Quando il formato glTF non è disponibile, i formati popolari come FBX, OBJ, o COLLADA sono comunque disponibili e mantenuti regolarmente.

## Caricamento

Solo alcuni loader (ad es. [page:ObjectLoader]) sono inclusi di default con three.js — altri devono essere aggiunti all'applicazione individualmente.

`import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';`

Una volta importato un loader, sei pronto per aggiungere e caricare un modello alla scena. La sintassi varia a seconda del loader utilizzato - quando vengono utilizzati altri formati, contralla gli esempi e la documentazione del loader. Per il formato glTF, l'utilizzo con gli script globali sarebbe:

`const loader = new GLTFLoader(); loader.load( 'path/to/model.glb', function ( gltf ) { scene.add( gltf.scene ); }, undefined, function ( error ) { console.error( error ); } );`

Per maggiori dettagli consulta la [page:GLTFLoader documentazione GLTFLoader].

## Troubleshooting

Hai passato ore a modellare un capolavoro artigianale, lo carichi nella pagina web e — oh no! 😭 è distorto, scolorito o mancante. Inizia con questi passaggi per la risoluzione dei problemi:

1. Controlla la console JavaScript per vedere se ci sono errori, ed accertati di aver usato la funzione di callback `onError` del meotodo `.load()` per visualizzare il risultato nella console.
2. Visualizza il modello in un'altra applicazione. Per il formato glTF, sono disponibili visualizzatori drag-and-drop per three.js e babylon.js. Se il modello viene visualizzato correttamente in una o più applicazioni, segnala il bug a three.js. Se il modello non è visualizzabile in nessuna applicazione, incoraggiamo vivamente di segnalare un bug all'applicazione utilizzata per creare il modello.
3. Prova a scalare il modello verso l'alto o il basso di un fattore di 1000. Molti modelli sono scalati diversamente, e molti modelli di grandi dimensioni non vengono visualizzati se la telecamera si trova all'interno del modello.
4. Prova ad aggiungere e posizionare una luce nella scena. Il modello potrebbe essere nascosto nell'oscurità.
5. Cerca le richieste delle texture fallite nel tab network degli strumenti per sviluppatori del browser, come `"C:\\Path\To\Model\texture.jpg"`. Utilizza path relativi al tuo modello come `images/texture.jpg` - ciò potrebbe richiedere una modifica del file del modello in un editor di testo.

## Chiedere aiuto

Se hai eseguito la procedura di risoluzione dei problemi qui sopra e il tuo modello ancora non funziona, il giusto approccio è chiedere aiuto per una soluzione più veloce. Scrivi una domanda sul forum three.js e, quando possibile, includi il tuo modello (o un modello più semplice con lo stesso problema) in qualsiasi formato disponibile. Includi informazioni sufficienti per consentire a qualcun altro di riprodurre rapidamente il problema - idealmente, una demo dal vivo.