# [name]

Gestisce e tiene traccia dei dati caricati e pendenti. Un'istanza globale predefinita di questa classe viene creata e utilizzata dai loader, se non viene fornita manualmente - vedi [page:DefaultLoadingManager].
In generale questo dovrebbe essere sufficiente, tuttavia ci sono volte in cui è utile che i loader siano separti - per esempio se si vuole mostrare barre di caricamento separate per gli oggetti e le texture.

## Codice di Esempio

Questo esempio mostra come utilizzare il LoadingManager per tracciare i progressi dell'[page:OBJLoader].

`const manager = new THREE.LoadingManager(); manager.onStart = function ( url, itemsLoaded, itemsTotal ) { console.log( 'Started loading file: ' + url + '.\nLoaded ' + itemsLoaded + ' of ' + itemsTotal + ' files.' ); }; manager.onLoad = function ( ) { console.log( 'Loading complete!'); }; manager.onProgress = function ( url, itemsLoaded, itemsTotal ) { console.log( 'Loading file: ' + url + '.\nLoaded ' + itemsLoaded + ' of ' + itemsTotal + ' files.' ); }; manager.onError = function ( url ) { console.log( 'There was an error loading ' + url ); }; const loader = new OBJLoader( manager ); loader.load( 'file.obj', function ( object ) { // } );`

Oltre ad osservare i progressi, un LoadingManager può essere utilizzato per sovrascrivere le URL della risorsa durante il caricamento. Questo può essere utile per le risorse che derivano dagli eventi di drag-and-drop, WebSockets, WebRTC, o altre API. L'esempio qui sotto mostra come caricare un modello in memoria utilizzando le URL del Blob.

`// Oggetti Blob o File creati quando i file vengono trascinati nella pagina web const blobs = {'fish.gltf': blob1, 'diffuse.png': blob2, 'normal.png': blob3}; const manager = new THREE.LoadingManager(); // Inizializza il manager di caricamento con la callback della URL const objectURLs = []; manager.setURLModifier( ( url ) => { url = URL.createObjectURL( blobs[ url ] ); objectURLs.push( url ); return url; } ); // Carica come di solito, quindi revoca gli URL dei Blob const loader = new GLTFLoader( manager ); loader.load( 'fish.gltf', (gltf) => { scene.add( gltf.scene ); objectURLs.forEach( ( url ) => URL.revokeObjectURL( url ) ); });`

## Esempi

[example:webgl_loader_obj WebGL / loader / obj]
[example:webgl_postprocessing_outline WebGL / postprocesing / outline]

## Costruttore

### [name]( [param:Function onLoad], [param:Function onProgress], [param:Function onError] )

[page:Function onLoad] — (opzionale) Questa funzione sarà chiamata quando tutti i caricamenti saranno terminati.
[page:Function onProgress] — (opzionale) Questa funzione sarà chiamata quando un elemento è completato.
[page:Function onError] — (opzionale) Questa funzione sarà chiamata quando un loader incontra degli errori.
Crea un nuovo [name].

## Proprietà

### [property:Function onStart]

Questa funzione verrà chiamata all'avvio del caricamento. Gli argomenti sono:
[page:String url] — La url dell'elemento appena caricato.
[page:Integer itemsLoaded] — Il numero di elementi già caricati finora.
[page:Integer itemsTotal] — La quantità totale di elementi da caricare.
Il valore predefinito è `undefined`.

### [property:Function onLoad]

Questa funzione sarà chiamata quando tutti i caricamenti saranno terminati. Il valore predefinito è `undefined` a meno che non venga passata nel costruttore.

### [property:Function onProgress]

Questa funzione sarà chiamata quando un elemento è completato. Gli argomenti sono:
[page:String url] — La url dell'elemento appena caricato.
[page:Integer itemsLoaded] — Il numero di elementi già caricati finora.
[page:Integer itemsTotal] — La quantità totale di elementi da caricare.
Il valore predefinito è `undefined` a meno che non venga passata nel costruttore.

### [property:Function onError]

Questa funzione sarà chiamata quando un loader incontra degli errori, con l'argomento:
[page:String url] — La url dell'elemento andato in errore.
Il valore predefinito è `undefined` a meno che non venga passata nel costruttore.

## Metodi

### [method:this addHandler]( [param:Object regex], [param:Loader loader] )

[page:Object regex] — Un'espressione regolare.
[page:Loader loader] — Il loader.

Registra un loader con l'espressione regolare passata. Può essere utilizzato per definire quale loader deve essere utilizzato per caricare file specifici. Un caso d'uso tipico è sovrascrivere il loader predefinito per le texture.

`// aggiunge un handler per le texture TGA manager.addHandler( /\.tga$/i, new TGALoader() );`

### [method:Loader getHandler]( [param:String file] )

[page:String file] — Il percorso del file.

Può essere utilizzato per recuperare il loader registrato per il dato percorso del file.

### [method:this removeHandler]( [param:Object regex] )

[page:Object regex] — Un'espressione regolare.

Rimuove il loader per l'espressione regolare passata.

### [method:String resolveURL]( [param:String url] )

[page:String url] — La url da caricare.
Data una URL, utilizza la callback del modificatore di URL (se presente) e restituisce un URL risolto. Se non è impostato alcun modificatore di URL, restituisce l'URL originale.

### [method:this setURLModifier]( [param:Function callback] )

[page:Function callback] — La callback del modificatore di URL. Chiamata con l'argomento [page:String url], e deve restituisce una [page:String resolvedURL].
Se fornito, la callback verrà passata ad ogni risorsa URL prima che la richiesta venga inviata. La callback deve restituire la URL originale, o una nuova URL per sovrascrivere il comportamento del caricamento. Questo comportamento può essere utilizzato per caricare le risorse dai file .ZIP, dalle API di drag-and-drop e dai Data URI.

Nota: I metodi seguenti sono progettati per essere chiamati internamente dai loader. Non possono essere chiamati direttamente.

### [method:undefined itemStart]( [param:String url] )

[page:String url] — La url da caricare.
Questo metodo dovrebbe essere chiamato da qualsiasi loader che utilizza il manager quando il loader inizia a caricare una url.

### [method:undefined itemEnd]( [param:String url] )

[page:String url] — La url caricata.
Questo metodo dovrebbe essere chiamato da qualsiasi loader che utilizza il manager quando il loader finisce di caricare una url.

### [method:undefined itemError]( [param:String url] )

[page:String url] — La url caricata.
Questo metodo dovrebbe essere chiamato da qualsiasi loader che utilizza il manager quando il loader va in errore caricando una url.

## Source

[link:https://github.com/mrdoob/three.js/blob/master/src/loaders/LoadingManager.js src/loaders/LoadingManager.js]